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THE WRITER'S TOOL Version 2.0 


Copyright 1984 Madison Micro 


INTRODUCTION 


1.0 OVERVIEW 

THE WRITER'S TOOL is a 20K machine-language program for fast, 
convenient, and integrated word processing on ATARI computers. With 
The Writer's Too! you can enter and edit text, save and retrieve text 
files on disk, and print text with a wide variety of formats. [The 
author used The Writer's Tool to write, edit, and print this manual.] 
Special conveniences allow extensive use of printer capabilities, 
including pica, elite, compressed, and proportional fonts, underlining, 
superscripts and subscripts, and more. 

You will find The Writer's Tool convenient and powerful, whether you 
want to write a short letter or a 200 page novel. The simple command 
structure, the use of prompts and error checking, and a handy 
reference card minimize the need for memorization or frequent 
references to the user's manual. When you do need help, the extensive 
reference guide, and the example-filled tutorial encourage you to use 
all of the considerable powers of The Writer's Tool. 

2.0 HARDWARE REQUIREMENTS 

COMPUTER: The Writer's Tool can be used with any ATARI computer 
with at least 48K of memory. This includes the 1200XL and 800XL, 
as well as the ATARI 800. 

DISK DRIVE: The Writer's Tool is provided in single-density disk 
format and can be used with the ATARI 810 or 1050 disk drives, or 
with a number of ATARI-compatible single and double-density 
drives. 

PRINTER: Almost any printer can be used, provided it connects 
directly to the ATARI serial bus, or it has a Centronics-compatible 
interface which allows it to be connected to the parallel port on an 
ATARI 850 Interface Module. Special print features of most 
popular printer are fully supported 

PRINTER INTERFACE: If your printer does not have a built-in 
interface which allows it to plug into the ATARI Serial Bus, then 
you will also need an ATARI 850 Interface Module, or an equivalent 
parallel printer interface. 

If you want to customize The Writer's Tool screen display 
characteristics and default formats, a BASIC cartridge may also be 
needed, unless you are using an 800XL, which has built-in BASIC. 
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3.0 HOW TO USE THIS MANUAL 


Hands-on experience is the most efficient way to learn how to use The 
Writer's Tool. Begin by working through the first five sections of the 
TUTORIAL. This provides many work-along examples, and step by step 
instructions in the use of The Writer's Tool. Although the tutorial is 
mainly written for the novice user, it will also be useful to the 
advanced user. 

Once you gain some experience, the REFERENCE GUIDE will become 
your primary source of information. The Reference Guide provides 
summaries of all commands and functions of The Writer's Tool, as well 
as more specific information about the printers supported by The 
Writer's Tool. This is primarily written for the experienced user. 

As you explore the more powerful functions, you will probably use the 
reference guide for brief explanations and reminders, and the tutorial 
for detailed examples when you need them. 

Don't be frightened by the amount of information presented in this 
manual. You don't need to know it all to make effective use of The 
Writer's Tool. Many of the functions are handled through prompts and 
menus. Once you get started, you may not even need the manual. 
When you do need to return to the manual, don't forget to use the 
INDEX at the back. 

A REFERENCE CARD can be found in the inside pocket of the manual 
cover. This briefly summarizes most The Writer's Tool commands, and 
is useful as a reminder once you have learned how to use the program. 
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4.0 SUMMARY OF FEATURES 


The following list highlights the features of The Writer's Tool. These 
are the essential ingredients which make it a word processor. Users 
who have no previous word-processing experience should not expect to 
understand immediately all of the features listed. This list is provided 
mainly to whet your appetite for learning how to use the program. 

INTEGRATED FUNCTIONS 

o Integrated text entry and editing functions; no need to switch 
between modes; editing commands available during text entry. 

o Editing and printing functions integrated into one program. No 
need to load different modules for different functions. 

CONVENIENT TEXT ENTRY AND EDITING 

o Two text entry options (TYPE-OVER or INSERT), each with 
different flashing cursors. 

o Dynamic word wrap keeps text readable at all times. Word wrap 
can be turned off for viewing and editing program files. 

o Cursor movement to beginning or end of text, to top or bottom of 
screen, to beginning or end of line, to next word, or 
up-down-left-right using arrow keys. 

o Rapid forward or reverse paging. 

o Insert/Delete by space or line. 

o Undelete command restores last line deleted. 

o Join command deletes all spaces to next character. 

o Clear text before or after cursor. 

o Mark, Copy, and Delete Blocks. Marked blocks highlighted in 
inverse video. 

o Search and Replace function allows search only, continue search, or 
search and replace with replace, skip or quit options. Allows wild 
card search character. 
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o Single keystroke insertion of special print format modifiers. Single 
keystroke insertion of header block. 

o Convert previously entered text from upper case to lower case, or 
from lower case to upper case. 

o CAPS-LOCK, INVERSE VIDEO, and CURSOR EXCHANGE key 
states displayed when active. CURSOR EXCHANGE feature allows 
one-handed movement of cursor. 

MENUS AND PROMPTS 

o Menus and prompts appear when needed. Prompts are provided for 
more complex functions. 

o Menus displayed at screen bottom in color and character luminance 
different from text display. 

AUDIO FEEDBACK 

o Different sounds are used to indicate errors, advisories, and task 
completions. Sounds can be output through computer speaker or 
monitor. 

WORD COUNTER 

o Word count, character count, and memory usage displays are 
available. 

DISK FILE MANAGEMENT 

o DISK directory available without return to DOS. Directory can be 
displayed or printed in double column format. Two disk drives 
supported. 

o INITIALIZE, LOAD, SAVE, and DELETE disk files. Warning 
messages appear when text buffer may be in jeopardy. SAVE 
automatically uses name of last file loaded unless rejected. 

o The Writer's Tool text files compatible with DOS files, allowing 
viewing and editing of a wide spectrum of disk files regardless of 
record length. 

o Double density disk drives are supported. Drive density can be 
controlled from within the program. 
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FLEXIBLE PRINT FORMATTING 


o Pica, Elite, Compressed, Proportional, and Correspondence Quality 
fonts are supported. 

o Single imbedded characters used to start/stop superscripts, 
subscripts, underlining, boldface, red print, italics, double-strike, 
and double-width printing. 

o Greek/Math character sets of NEC 8023 and C.ITOH PROWRITER 
printers can be printed. 

o Word wrap on printout can be turned off; useful for listing BASIC 
and other program files. 

o Imbedded printer control codes and even graphics can be used 
without losing word-wrap and justification capabilities. This allows 
almost any printer to be used to its fullest. 

o Right justification, split justification, centering, and column 
alignment with imbedded tabs; supported for both proportional and 
standard character sets. 

o Double-width characters can be mixed with standard characters 
without causing justification errors. 

o Format parameters can be set externally or by means of imbedded 
format commands. Multiple format changes can be made in one 
format line. 

o Print format options include font, page length, footer starting line, 
left margin, line length, indent, tab positions (for up to 8 tabs), line 
spacing (up to four options), justification (up to four options), word 
wrap on/off, header and footer blocks with imbedded page numbers, 
text centering, vertical grouping, page eject, space between double 
columns, and reset to default values. 

o Headers and footers can be of any length, with centered, left, or 
right-justified page numbers combined with textual information. 
Header and footer formats can be different from main text and 
from each other. Split justified lines can be alternated 
automatically on even pages. 

o Soft hyphens can be inserted to produce automatic hyphenation. 
Hard spaces are also supported. 
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o Default formats allow printing most text without using format 
commands. Defaults can be customized by user. 

o Tables and other text blocks can be automatically kept together on 
a single page. 

o Print control includes continuous or wait-at-page-end options, abort 
or pause after any line, start at any point in text, and linked 
printing of a sequence of files. 

SCREEN PREVIEW 

o Page breaks and format commands can be verified by screen 
preview prior to printout. Printing can be deferred to any page 
number. 

LINKED PRINTING 

o Linked printing allows continuous printing of an unlimited number 
of files as one document. Disk files can be linked internally or 
externally linked and/or merged with text in memory buffer. 

MERGED PRINTING 

o Prompted creation of data base files. 

o Merged printing of text with data base items or keyboard entries. 

CUSTOMIZATION 

o Program defaults can be easily customized: cursor flash rate and 
luminance, screen colors and luminance, sound output, default 
printer, default format parameters can be modified. 

o Printer and format default files can be loaded when desired or set 
to load automatically when the program starts. 



The Writer's Tool Version 2.0 


Copyright 1984 Madison Micro 


TUTORIAL 


This tutorial provides a step-by-step tour through the main functions of 
The Writer's Too!. By detailed examples and illustrations we hope to 
encourage your full use of the considerable powers this program 
provides. You will often be given numbered steps to perform, as well 
as explanations and screen images of what should happen after each 
step. If you read through each step before performing it, you will be 
more aware of what's happening and less likely to make mistakes. 

Don't be afraid of making mistakes. It's a natural part of the learning 
process. However, some mistakes may disturb the correspondence 
between what the tutorial says should happen and what you actually see 
happening. In this case, go back to the beginning of the section you're 
working on and start over. 

The tutorial begins by showing you how to load the program and get it 
running. This is followed by lessons on simple text entry and editing, 
on using the disk drive to save and retrieve text, and, finally, on using a 
printer to get your text on paper. 

The essentials are covered in the first five sections. More detailed 
information about producing special print formats and using special 
printer capabilities is presented in Sections 6-11. 


TUTORIAL CONTENTS IN BRIEF 
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Entering Text 
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1.0 LOADING THE WRITER'S TOOL 

(1) Turn off your ATARI computer and insert The Writer's Tool 
cartridge. 

(2) Turn on disk drive #1 and wait for the busy light to go out. 

(3) Insert The Writer's Tool disk in drive #1. 

(4) Turn on your computer. 

The Writer's Tool program will now start loading. In about 10 seconds 
it will display the following Sign-on screen: 


THE HRITER'S TOOL 

UERSXON 2.0 
Produced by OSS. Inc . 
Copyright 1984 Madison Micro 


After another 20 seconds the program will complete the load process. 
You should then see a mostly blank screen with a flashing cursor in the 
upper left hand corner. This is the EDIT screen. If you do not see this 
screen, remove The Writer's Tool disk and carefully repeat the load 
procedure described above. 

Once the EDIT screen appears. The Writer's Tool is ready for text 
entry and editing. [The message at the bottom of the screen should be 
ignored until later.] 



2.0 ENTERING TEXT 


Entering text is much like typing on a typewriter, except that you 
should 


enter RETURN at the end of a paragraph, 


but not at the end of every line. As you enter characters on the 
keyboard, they will appear on the screen at the position of the cursor 
(the flashing rectangle). If you type an incorrect character, 


press 


DELETE 

BACKS 


to move the cursor back one character, 


then type the correct character. Before pressing a letter key. 


hold down SHIFT to produce an upper case character. 


Now enter the following text: 

Happy days are here again.RETURN 
RETURN 

The time has come for all good men and 
women to come to the aid of their 
children.RETURN 

Each RETURN will produce a left arrow on the screen, marking the end 
of a paragraph or a blank line. When you are done typing, the display 
should look like this: 


Happy days are here again.* 

* 

The tine has coite for all good Men and 
woMen to coMe to the aid of their 
children.* 




3.0 EDITING TEXT 


Editing what you've typed is accomplished by moving the cursor to the 
place that needs changing and then deleting, inserting, or retyping the 
characters needed. Exercises in this section will make use of the text 
entered in Section 2.0. 

3.1 MOVING THE CURSOR 

(1) Press and hold down the CTRL key located on the left edge of the 
keyboard. 

(2) While you are holding down the CTRL key, press one of the four 
arrow keys to move the cursor in the direction of the arrow. If you 
keep the arrow key depressed longer than 3/4 second, it will begin 
to repeat. 

(3) Move the cursor to the beginning of the text just entered, then try 
each of the following methods of cursor movement: 


CTRL + W 

CTRL + A 

CTRL + Z 

CTRL + B 

CTRL + E 


to move to the next word 


to move to the beginning of a line 


to move to the end of a line 


to move to the beginning of the text 


to move to the end of the text 


TAB 


to move in 5-character steps 
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3.2 INSERTING AND DELETING CHARACTERS 


One way to insert a character is to press 


CTRL 


INSERT 


to insert a space at the cursor. 


then type the character in the space provided. You can use 


CTRL 


DELETE 

BACKS 


to delete a character at the cursor. 


EXAMPLE 

This example uses text entered in Section 2.0. 

(1) Use CTRL-[arrow] to move the cursor to the 2nd 'p' in 'happy': 


Hapfty days 


(2) Press CTRL-DELETE once. This will delete the 'p' and move the 
following characters one space to the left, leaving the cursor at the 

.y’ ; 


HapR days 


(3) Press CTRL-INSERT once. This inserts a space at the cursor: 


Haply days 


(4) Type a 'p* to restore the deleted character: 


HappP] days 







3.3 DELETING AND RESTORING LINES 


The following example shows how to delete a screen line and how to 
restore the last line deleted. The restore function is used to recover 
from accidental deletions, to insert multiple copies of a line, or to 
move a line from one place to another. 

(1) Move the cursor to the first line of the second paragraph entered in 
Section 2.0 (the cursor can be anywhere on that line): 


Happy days are here again.* 

♦ 

Thefltime has c<me for all good men and 
women to come to the aid of their 
children. «• 


(2) Enter SHIFT + 


DELETE 

BACKS 


to delete the screen line: 


Happy days are here again.♦ 

* 

■women to come to the aid of their 
children. ♦ 


(3) Enter CTRL + U to Undelete the deleted line: 


Happy days are here again.♦ 

«■ 

Qhe time has come for all good men and 
women to come to the aid of their 
children .♦ 


(4) For an amusing effect move the cursor to the beginning of the first 
paragraph, then use CTRL-U twice to insert two more copies of the 
previously deleted line. 






3.4 USING INSERT AND JOIN 


INSERT AND JOIN is an editing technique which first inserts a large 
space for text entry, then joins the trailing text to the inserted text by 
deleting the unused space. 

Before starting this demonstration, use CTRL-B to move the cursor to 
the beginning of the text and SHIFT-DELETE to clear the screen. 

Now type the following text: 

Now is the time for all good men to 
come to the aid of their 
country. RETURN 


Suppose you want to insert the word 'best' before the word 'time' in 
the sentence you just typed. Here is one technique for doing it: 

(1) Move the cursor to the beginning of the word 'time'. The display 
should now look like this: 


Now is the Qine for all good Hen to 
cone to the aid of their country.* 


(2) Enter 


SHIFT 


INSERT 

+ 


to make space: 


Now is the ■ 

tine for all good Men to 
cone to the aid of their country.* 





(3) Type the word 'best 1 (don't forget the space at the end of the 
word). This still leaves a large gap between 'best' and 'time' as 
shown below: 


Now is the best ■ 

tine for all good wen to 
tone to the aid of their country.* 


(4) Enter CTRL + J to re-join the text: 


Now is the best Qine for all good wen 
to cowe to the aid of their country.* 


SUMMARY OF INSERT AND JOIN 

1. Move the cursor to the point where the insertion is needed. 

2. Open up space by entering SHIFT-INSERT. 

3. Type the insert. 

4. Remove unused space after the cursor by entering CTRL-J. 
INSERTING LARGE AMOUNTS OF TEXT 

If you need to insert several lines of text you can open up as many 
blank lines as needed by pressing SHIFT-INSERT once for each line. 
For very large inserts press and hold both SHIFT and CTRL keys, then 
press INSERT. This will open up all the space available, and the text 
after the cursor will disappear from view temporarily. When you finish 
the large insert, press CTRL-J to remove the unused space after the 
cursor. The text that disappeared will then reappear at the cursor 
position. 
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3.5 INSERT AND TYPEOVER MODES OF TEXT ENTRY 


For all of the previous tutorial examples EDIT has been set to the 
TYPEOVER mode of text entry. In this mode a character entered from 
the keyboard writes over the character at which the cursor is 
positioned. 

The Writer's Tool also provides an INSERT mode of text entry. The 
way this mode works is illustrated in the following example. 

(1) Clear the screen and enter this text: 

Now is the time for all good men to 
come to the aid of their country. 


(2) Press CTRL + I to turn on the INSERT mode. 


[Note that the cursor now changes to a flashing vertical bar. The 

vertical bar is on the left edge of the character at the cursor position.] 

(4) Move the cursor to the first character of the word 'time'. The 
vertical bar should be flashing at the left edge of the't'. 

(5) Type the word 'best '. Note that all of the text beyond the cursor is 
pushed aside as new characters are entered. 

(6) Now delete the word by pressing the DELETE key repeatedly. Note 
that the text to the right of the cursor is pulled along with the 
cursor as it moves to the left during the deletion process. This is a 
characteristic of the INSERT mode only. 

WORD REPLACEMENT IN INSERT MODE 

(1) Position the cursor at the first letter of the word 'good'. 

(2) Type the word 'evil*. 

(3) Use CTRL-DELETE until 'good' is deleted. As you can see, 
CTRL-DELETE works the same in the INSERT mode of text entry 
as it does in the TYPE-OVER mode. 


(4) Press CTRL + T to restore the TYPEOVER mode. 
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3.6 USING BLOCK COMMANDS 


Here the term text block means any sequence of ordinary characters 
between two special characters called block markers. A block can be 
as short as one character or longer than 18,000 characters. It can be a 
word, paragraph, or anything. Once a block is marked, it can be 
copied, deleted, or moved. 

The block commands allow you to rearrange the order of paragraphs, to 
delete specific parts of a document, or copy one part of a document 
into another part. 

Before these functions can be demonstrated, some text is needed to 
work with. Clear the screen, put the cursor at the beginning of the 
text and enter the following: 


Now is the time for all good men to 
come to the aid of their country. 
These are the times that try men's 
souls. Ask not what your country can 
do for you.RETURN 


The following demonstration shows how to rearrange the order of the 
first two sentences. 

MARKING A BLOCK 


(1) Move the cursor to the first letter of the word 'These': 


BEFORE 
1st MARK: 


Now is the tine for all good nen to 
cone to the aid of their country. 
Dhese are the tines that try nen's 
souls. Ask not what your country can 
do for you.* 




(2) Enter CTRL-M. This inserts a special marker into the text and 
causes all following text on the screen to be displayed in inverse 
video. The cursor is left at the marker character (the white 
rectangle with a horizontal bar through the middle). To get a 
better view of what happened use CTRL-DELETE to get rid of the 
marker, then enter CTRL-M again. Now the first marker is in 
position: 


AFTER 
1st MARK: 


Mow is the tine for all good t*en to 
cone to the aid of their country. 


-These are the tines that try ner^M 
souls. Ask not what your cou ntry can 
for you. 


(3) Move the cursor to the 'A' in 'Ask', then enter CTRL-M to insert 
the second block marker. Now only the marked sentence will be 
highlighted in inverse video: 


AFTER 
2nd MARK: 


Now is the tine for all good Men to 
cone to the aid of their country. 

HniimC ftsk not what your country can 
do for you.* 


COPYING THE BLOCK 

(4) Now that the desired block is marked, move the cursor to the 
beginning of the text using CTRL-B. 


(5) Enter CTRL-C. This inserts a copy of the marked block at the 
beginning of the text and moves the rest of the text forward: 


AFTER 

CTRL-C: 


Qhese are the tiMes that try Men's 
souls. Now is the tiMe for all good 
Men to co we to the aid of their 
country. 3<iU-4JB4J 
nn ‘ M.[jii»--»-iiitlTP^C Ask not what your 
country can do for you.* 







DELETING THE BLOCK 


(6) Enter CTRL-X This deletes the marked block and the marker 
characters as well: 


AFTER 

CTRL-X: 


Qhese are the tines that try (ten's 
souls. Now is the tine for all good 
Hen to cone to the aid of their 
country. Ask not what your country 
can do for you.t 


This completes the move which reversed the order of the first two 
sentences. 

DELETING MARKERS ONLY 

If you want to delete block markers only, move the cursor to each 
marker and use CTRL-DELETE. 


SUMMARY OF BLOCK COMMANDS 

Important facts to remember from the block command examples are as 
follows: 

1. CTRL-M inserts a block marker. 

2. CTRL-C inserts a copy of the marked block at the cursor. 

3. CTRL-X deletes a marked block and its markers. 

The most important restrictions on using block commands are these: (1) 
you can't copy or delete a block unless it has been marked, (2) you 
can't copy a block into itself, (3) you can't copy a block past the end of 
text already entered. Error messages which result from attempting 
illegal block commands are fully described in the REFERENCE GUIDE. 
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3.7 CHANGING CASE 

The case of previously entered text can be changed without retyping. 
Move the cursor to the beginning of what you want changed, then 

enter CTRL + L to convert to lower case, or 

enter CTRL + K. to convert to UPPER CASE. 


These commands only affect text which has already been entered. 


3.8 PAGING COMMANDS 

Paging commands can move the cursor {and scroll the text) in 20-line 
steps either forward or backward. If the cursor is not at the top or 
bottom of the screen, the first action of a paging command is to move 
the cursor to the top of the screen (page reverse) or to the bottom of 
the screen (page forward). These commands allow you to move the 
cursor rapidly through a large amount of text. 


Enter CTRL + F to page forward. 


Enter CTRL + R to page in reverse. 


Here the term page is used to mean 20 screen lines of text. 
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4.0 CHANGING KEYBOARD AND DISPLAY CHARACTERISTICS 


4.1 SETTING UPPER AND LOWER CASE 

The Writer's Tool begins in the lower case mode. In this mode you 
must hold down the SHIFT key to produce an upper case letter. If you 
want to enter mainly upper case letters, 


press 


SHIFT 


CAPS 
+ LOWR 


to set the upper case mode. 


This will display "CAPS LOCK" on the status line and produce upper 
case letters from unshifted key-ins. [NOTE: The 800XL CAPS/LOWR 
key only has the CAPS label.] 


press 


CAPS 

LOWR 


to return to lower case mode. 


4.2 INVERSE VIDEO CHARACTERS 


Normal characters are white on a blue background. Inverse characters 
are blue on a white background. To enter inverse video characters, you 
must first set the keyboard to INVERSE mode: 


press 




• turn on the INVERSE mode. 


The first key appears on the old ATARI computers, while the second 
appears on the XL series computers. The key function is the same. 
Just the labels are different. 


When the inverse mode is turned on, you should hear a beep and see 
"INVERSE" displayed on the status line. Keyboard entries will then 
produce inverse video characters until you return the keyboard to 
normal: 


press 




to turn off the INVERSE mode. 


The use of inverse characters will be explained later. Now just 
remember how to turn off the inverse mode when it is accidentally 
activated. 




4.3 ONE-FINGERED CURSOR MOVEMENT 


In some cases, using a two-key combination to move the cursor is a 
nuisance. When you need one-fingered cursor control, 


press CTRL 


CAPS 
+ LOWR 


to activate CURSOR EXCHANGE. 


This will produce the message "CURSOR EXCH" on the status line. At 
this point you will be able to move the cursor just by pressing the arrow 
keys. The cursor controls have been exchanged with the unshifted 
characters +, -, *, and =. To enter these characters you will thus need 
to hold down the CTRL key, while pressing +, -, *, or =. When you want 
to return to the normal mode of cursor control, 


press CTRL + 


CAPS 

LOWR 


to deactivate CURSOR EXCHANGE. 


4.4 CONTROLLING THE STATUS LINE DISPLAY 

If you find the status line display of the keyboard settings annoying, 
then 


press SHIFT + to erase the status line. 

If you want to know what the keyboard settings are, then 

press CTRL + ? to restore the status line. 
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4.5 CHANGING THE TYPEOVER CURSOR 


In the typeover mode of text entry, the cursor position is indicated by 
flashing between the character at the cursor and its inverse video 
representation. If this doesn't appeal to you, 




press SELECT to switch cursors. 


The first time you press SELECT, the cursor will change to a flashing 
underline. Pressing SELECT again will restore the original inverse 
video cursor. 


4.6 WORD WRAP CONTROL 

You may have already noticed that The Writer's Tool keeps words from 
being split between the end of one line and the beginning of the next. 
This function is called word wrap. Its purpose is to make the displayed 
text as readable as possible. However, there are times when you may 
want to turn off the word wrap function: (1) when you want to know 
exactly how much space there is between the last word of one line and 
the first word of the next, or (2) you are editing program files for 
which words are not the natural text unit. 

EXAMPLE 

(1) Press RETURN, then enter the following text: 

Now is the time for all good men to 
come to the aid of their country. 



(2) Press START 


to turn off word wrap: 


«■ 

Now is the tine for all good nen to co 
we to the aid of their country.! 


(3) Press START 


to turn on word wrap: 


«■ 

Now is the tine for all good wen to 
cone to the aid of their country.! 
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5.0 USING MAIN MENU FUNCTIONS 


So far, the tutorial has focussed on using the EDIT system of The 
Writer's Tool. Through the MAIN MENU you can activate other 
necessary word processing functions, the most important of which are 
printing, saving, and retrieving text. 


5.1 THE MAIN MENU 

Press OPTION or enter CTRL-O to display the MAIN MENU: 


NAIN MENU 

SEARCH E3I5KIO QRINT BLEAR EDIT 


This display will occupy the bottom four lines of the screen (also used 
as the "command window"). When the main menu is displayed, you 
cannot type characters into the text buffer (the memory space 
reserved for text). 

The first letter of each function name on the menu is highlighted in 
inverse video. Pressing the corresponding letter key will activate the 
function. To see how this works, 


press E to return to EDIT. 

The other functions on the menu are summarized below: 

SEARCH manages search and replace activities. 

DISKIO (stands for DISK Input/Output system) manages the transfer of 
text between disk storage and computer memory. 

PRINT handles formatting and printing of text. 

CLEAR handles deletion of large blocks of text from memory. 

The following subsections show how to access and use these functions. 




5.2 USING SEARCH AND REPLACE 


The search and replace function provides a fast and convenient way to 
find particular words or phrases within a large body of text, and to 
make repetitive replacements of one word or phrase with another, no 
matter where they are needed and no matter how many are needed. 

The Writer's Tool supports three variants of this useful function: (1) 
search for first occurrence and return to EDIT, (2) continue search in 
EDIT, and (3) search and replace with verify, skip, or quit options. 
Each of the three variants is illustrated by examples. 

Before working through the examples clear the screen and enter the 
following sentence: 

Now is the time for all good men to come 
to the aid of their country. RETURN 


SEARCH AND RETURN 

(1) Enter CTRL + B to move the cursor to the beginning of the text 
(The Writer's Tool only searches from the cursor forward). 

(2) Press OPTION to display the main menu at the bottom of the 
screen. (When this 4-line window is displayed, normal keyboard text 
editing is temporarily suspended.) 


(3) Press S to activate the search function: 


ENTER /OLD/NEM/ 1331 or 


/OLD/ cm 


[In this prompt, "old" refers to the object of the search and "new" 
refers to a replacement string. The slash character "/" is a delimeter 
and can be any character which does not appear in old or new strings.] 

(4) Answer the prompt by entering "/the", but don't press RETURN yet. 


ENTER /OLD/NEH/ HBl or /OLD/ (331 
/the! 





The screen should now look like this: 


Qoy is the tine for all good nen to 
cone to the aid of their country. 



(5) While you are watching the screen, press RETURN to activate the 
search. A beep of medium pitch will be sounded when the first 
occurrence of "the" is found, and the cursor will appear at the first 
letter. The command window will then disappear and control will 
return to EDIT. 

CONTINUE SEARCH 

Once a search string is defined, as was done in the previous steps, it 

then becomes possible to continue searching without leaving EDIT: 

(6) Enter CTRL-S. This moves the cursor to the next occurrence of 
"the", which was the last search string defined. Note that the line 
containing the found string is always moved to the top of the 
screen. 

(7) Enter CTRL-S again. This time the search routine finds the 'the' in 
"their". [This could have been avoided by entering "/ the /" instead 
of "/the" in step 4.] 

(8) Enter CTRL-S once more. This time you should hear a high-pitched 
beep, and see "NOT FOUND" temporarily displayed on the status 
line. 
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SEARCH AND REPLACE 


The following example makes use of the same text entered at the 

beginning of this section. 

(1) Move the cursor to the beginning of the text. (Use CTRL-B) 

(2) Press OPTION or CTRL-O to display the main menu. 

(3) Press S to activate the SEARCH function. 

(4) Answer the prompt by entering "/good/evil/",RETURN. The cursor 
will move to the first letter of "good", a medium pitched beep will 
sound, and the prompt "CHOOSE Replace, Skip, or Quit" will 
appear: 


Nov is the tine for all Hood Men to 
coNe to the aid of their country.« 



(5) Press R to make the replacement. Immediately afterwards a 
slightly higher pitched beep will indicate that there are no more 
occurrences of the word "good" in the remaining text. Then you 
will see the message "NOT FOUND", and control will return to 
EDIT. 
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SKIP AND QUIT 


Using the same text as the previous examples, suppose you want to 

replace "men" with "women". 

(1) Move the cursor to the beginning of the text. 

(2) Press OPTION for the main menu, then press S to activate 
SEARCH. 

(3) Answer the prompt by entering "/me/wome/",RETURN. [This is not 
the best way to replace "men" with "women", and is only used to 
show the use of SKIP and QUIT responses.) 

(4) The first occurrence of "me" is in the last two characters of "time". 
Since this is not where the replacement is wanted, answer the 
"Replace, Skip, or Quit" prompt by pressing the S key. This will 
leave "time" unchanged and the cursor will advance to the "m" in 
"men". 

(5) Answer the prompt by pressing the R key. This will cause "men" to 
be changed to "women", and the cursor will then move to the "m" in 
"come". 

(6) This time answer the prompt by pressing the Q key. Control will 
then return to EDIT, and the search and replace function will be 
aborted. 

(7) Press CTRL-B to bring ail the text back into view so you can see 
the effects of the replacement. 

SEARCH AND DESTROY 

Here the search and replace function is used to delete the word "time" 

by replacing it with nothing. 

(1) Make sure the cursor is at the beginning (Enter CTRL-B). 

(2) Press OPTION, then S to activate SEARCH. 

(3) Enter "/time //".RETURN (the double slash indicates "replace with 
nothing", in other words, delete). 

(4) Press the "R" key to effect the replacement. Since there are no 
more occurrences of "time", control will again return to EDIT. 
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5.3 USING A DISK DRIVE 


This section demonstrates the functions of the Disk Input/Output 
System (DISKIO). 

[Before proceeding any further, use CTRL-B to move the cursor to the 
beginning of the text buffer, then press and hold SHIFT-DELETE untii 
all text is deleted.] 

GETTING TO THE DISK I/O SYSTEM 

(1) Press OPTION to display the main menu. 

(2) Press D to activate the disk system. You should now see the 
following screen display: 


DISK I/O SYSTEM 

DIR (Directory) for Disk Q or & 
LOAD Henory fron Disk File 
SAVE MeNory to Disk File 
DEL (Delete) Disk File 
IMIT (Initialize) Drive or Disk 


POINTERS 


3 (used by LOAD, SAVE) 


CURSOR 

808 


TXTEND 

888 


MEHERD 
22,383 


SPACE 

22,383 



DISK I/O SYSTEM commands are briefly described in the upper part of 
the screen and presented in a new menu at the bottom of the screen. 
(This menu works the same as the main menu.) 







SUMMARY OF DISKIO COMMANDS 


Read the following command descriptions but don't try any just yet. 

1 2 (DIR) This displays the names of the files on a disk (the disk 
directory) and the disk space used by the files. A directory can be 
obtained for drive #1 or drive #2 by pressing 1 or 2. 

LOAD This reads characters from a disk file and copies them into 
the text buffer (the part of your computer memory reserved for 
text). The copied text will start wherever the cursor was positioned. 
This command does not change anything on the disk. 

SAVE This copies characters from the text buffer to a disk file. 
The save process starts at the cursor and ends at the last character 
entered in the text buffer. This does not alter the text in the 
buffer. 

DEL (DELETE) This is used to erase a disk file, and thus makes 
more space available for storing new information. 

JNIT (INITIALIZE) This is used to prepare a blank disk for storing 
data or to change between single and double density disk formats. 
It can also be used to completely erase an old disk. 

EDIT Pressing E returns program control to EDIT. 


DESCRIPTION OF POINTERS 

CURSOR This is where the cursor is positioned relative to the be¬ 
ginning of the text buffer. LOAD and SAVE commands begin at the 
cursor position. 

TXTEND This is where the last character was entered in the text 
buffer. A SAVE command will save all characters from CURSOR 
through TXTEND. A LOAD command will set TXTEND to the 
position of the last character loaded. 

MEMEND This is the size the text buffer (the total number of 
characters which can fit in the buffer). 

SPACE This is how much room is left for entering more text (the 
difference between MEMEND and TXTEND). When the text buffer 
is empty, SPACE and MEMEND will be the same. 
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DISPLAYING A DIRECTORY 


If you can't remember the name of a text file you saved previously, or 
you can't remember on which disk you saved it, or you want to save a 
file and you don't know which disk has enough room to hold it, then the 
first thing you will need is a directory of the disk. To see how this 
works, do the following: 

(1) Make sure that the Disk I/O System screen is displayed. If it isn't 
use OPTION, then D to activate DISKIO. 

Before going to the next step make sure that The Writer's Tool disk is 
in drive #1. 

(2) Press 1 to display the directory for drive #1: 


DOS 

SYS 

846 

AUTORUN 

SYS 

114 

MERGE 

OBJ 

820 

CUSTOM 

BOS 

0/2 

AT825 

ppp 

886 

AT182S 

PPP 

886 

A71827 

PPP 

886 

CRII 

ppp 

88b 

FX80 

PPP 

886 

FX88M 

ppp 

80b 

GEH1BX 

ppp 

886 

GENERIC 

ppp 

00b 

ML82A 

ppp 

896 

HL92 

ppp 

08b 

MX88 

ppp 

886 

MX80G 

PPP 

00b 

HX88GS 

PPP 

086 

NEC8823 

PPP 

886 

PROWRTR 

ppp 

886 

RX88 

PPP 

00b 

DEMO 


048 

FDEMO 


88b 

LDEKO 


802 

PDEMO 


004 

288 FREE 

SECTORS 






The directory listing shown above (single density version) has a header 
and two major columns, each with three sub-columns of information. 
The header (which now reads Dl:) tells which disk drive the directory 
came from. The first two sub-columns list the first and last parts of 
the filenames: the file "DOS.SYS" has "DOS" listed in the first 
sub-column and "SYS" in the second sub-column. The third sub-column 
lists the number of disk sectors used by each file. The last item in the 
directory display (FREE SECTORS) shows how much room is left on the 
disk. 
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PRINTING A DIRECTORY 


;£ Lc 


-cr 


To produce a printed copy of the disk directory, follow the same 
procedure used to display a directory, except press the ©PTJ&N switch 
before pressing 1 or 2, and hold down the OPTION switch until the 
directory begins printing. >eX£<-T 

LOADING A DISK FILE 

This example continues the previous one, and assumes that The Writer's 
Tool disk is in drive #1, and the directory is displayed. 

(1) Press L to activate the load process. This will produce the prompt 
"LOAD WHICH FILE?". 

(2) Enter 'DEMO 1 ,RETURN (Dl:DEMO is also acceptable; if you later 
want to load a file from drive #2, you must use "D2:" at the 
beginning of the filename). 

(3) If you made a mistake in step (2), then answer the prompt "ARE 
YOU SURE (Y/N)" by entering 'N',RETURN, and go back to step 
(1). Otherwise, enter 'Y',RETURN. This will start the load process 
(you should now hear the disk drive clicking and whirring). When the 
load is complete, a low pitched beep will sound and program control 
will return to EDIT. This means you have a successful load. 

FILE-NAMING RULES 

A disk file name must begin with an upper case letter and use only 
upper case letters or numbers for the remaining characters. The name 
may have two parts: a first name having as many as eight characters, 
and a last name up to three characters long. The first and last names 
must be separated by a period. The period is not displayed in the 
directory listing. 

A filename may also need a prefix. For example D2:LETTER has the 
prefix D2: to specify that the file LETTER is on disk drive #2. In most 
cases, filenames specified without a prefix are assumed to be on drive 
# 1 . 


T-25 



INITIALIZING A DISK 


Before a new blank disk can be used for data storage, a special 
magnetic pattern must be written on the disk surface. This process is 
called "initializing" (or "formatting") the disk. The following example 
shows how to do it. 

(1) Remove The Writer's Tool disk from drive #1. 

(2) Insert a blank disk in drive #1. 

(3) Enter the DISK system as follows: use OPTION to display the main 
menu, and then press D to activate DISKIO. 

(4) Now that the DISK I/O SYSTEM screen is displayed, press I to begin 
the initialization. You will then see the prompt "Which Disk Drive 
(1 or 2)?". 

(5) Enter RETURN or just RETURN. This will display the prompt: 


Set Drive Density: Bingle double 
or (initialize Disk 


(6) Press 'I' to initialize the disk in the selected drive. (Do not attempt 
to change disk densities before reading Appendix 3.) Because 
initializing a disk will completely erase it, you will be asked "ARE 
YOU SURE (Y/N)?". 

(7) Answer with 'Y',RETURN. The message "INITIALIZING DISK" will 
then appear. After about 40 seconds, when the initialization 
process is completed, the directory of the initialized disk will be 
displayed. This will show only the number of sectors available for 
storage. 

(8) Press E to return to EDIT. 

[NOTE: initializing a used disk will erase all previously stored 

information.] 




SAVING TEXT ON A DISK 


This example requires a formatted (initialized) disk and The Writer's 
Tool disk. If you don't have a formatted disk, go back to the section on 
initializing a blank disk. 

To save text in a disk file, you first need some text in the memory 
buffer. If you've worked through the previous two examples, you should 
have a copy of the DEMO file already in the buffer. If not, you should 
either go back and work through those sections or enter something of 
your own choosing. 

The following example will save text in the computer memory on a 
formatted blank disk. 

(1) Move the cursor to the beginning of the text buffer. This is needed 
because the SAVE function only saves text from the cursor position 
to the end of the text. 

(2) Press OPTION to display the main menu, then press D to display the 
main DISK I/O SYSTEM screen. 

(3) Make sure that a blank formatted disk is inserted in drive #1. 

(4) Press S to activate the save function. This will produce one of 
the following prompts: 


IF DEMO 
WAS LOADED 
PREVIOUSLY: 


SAVING TO-0:DEMO 

OK TO CONTINUE tY/NJ?■ 


IF NOTHING 

WAS LOADED SAVE TO WHICH FILE?! 

PREVIOUSLY: 


If you got the second prompt, go to step (5). 





The first prompt appears if you have previously loaded a disk file. The 
Writer's Tool keeps track of the name of the last file loaded and gives 
you a chance to save the current text under the same name. This is 
especially useful if you are editing an old file and want the new version 
saved under the old name. However, to continue with this example, 
answer the "OK to CONTINUE..." prompt with 'N',RETURN, and 
proceed with step (5) when the next prompt appears. 

(5) Answer the prompt with 'JUNK',RETURN (as usual, do not enter 
the quotes or the comma). This will produce the prompt "ARE YOU 
SURE (Y/N)?" 

(6) Answer the last prompt with 'Y',RETURN. The save will then 
begin. While the save is taking place, the message "SAVING TO 
D:JUNK" will be displayed. When the save is complete, the 
directory will be displayed for the disk which now contains the 
saved file. This verifies that the save was completed successfully. 

(7) Press E to return to EDIT. 


DELETING A DISK FILE 

This example assumes that you have a disk containing the file "JUNK", 

and that this disk is inserted in disk drive #1. This will be the case if 

you have worked through the previous section. 

(1) Enter the DISK I/O SYSTEM. 

(2) Press 1 to display the directory for the disk in drive #1. The 
directory listing should show that JUNK is one of the disk files 
(probably the only one). 

(3) Press D to start the DELETE function. This will display the 
prompt "DELETE WHICH FILE?". 

(4) Answer the prompt with 'JUNK',RETURN. This will produce the 
prompt "ARE YOU SURE (Y/N)?" 

(5) Answer the last prompt with 'Y',RETURN. While the delete is 
taking place the message "DELETING D:JUNK" will be displayed. 
When the delete is completed, the directory for the disk in drive #1 
will be displayed. If it shows that "JUNK" is no longer present, then 
the delete was successful. 

(8) Press E to return to EDIT. 
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5.4 USING A PRINTER 


The contents of the text buffer can be printed using the PRINT 
SYSTEM. 

To provide a standard sample of text for the examples of this section, 
move the cursor to the beginning of the text, then use the Disk I/O 
System to LOAD the "PDEMO" file from The Writer's Tool disk. [If 

you get a warning that the text buffer will be written over, just enter 
'Y',RETURN to continue.]. 

ACCESSING THE PRINT SYSTEM 

(1) Once the "PDEMO" file is loaded in the text buffer, press 
OPTION or CTRL-O to display the main menu. 

(2) Press P to display the Print System screen: 


PRINT SYSTEM 


FORMAT CONTROLS 


VIEH->PRINT V B 


PAGE LENGTH P 66 PAGE NUMBER N 1 

LINE SPACNG 5 1 LINE LENGTH L 64 

FOOTER LINE B 56 LEFT MARGIN M 8 

CHAR. FONT F 1 INDENT I 8 

5INGL SHEET H 8 JUSTIFY J 1 

TABS DOUBLE COL. X 8 

T 5,18,28,38,48,58,68,78 


Group n Lines: .Gn* 
split Justify: Left\Right«- 
Alternate,Center: .A*, .Cf 
Defaults,Eject: .Df, .E* 
Header,Footer: :Hf, :F«- 

lil:H!H4:H GENERIC lIHiTCPlH 864 


BNAT QRINT DINK GXRGE BHNGE BDIT 


The print format parameters and their default values are listed just 
below the heading "FORMAT CONTROLS". Each item in this list has a 
descriptive name, a letter code, and a default value. The first item, 
for example, has the descriptive name "PAGE LENGTH", the letter 
code "P" and the default value of "66". This means that the printed 

_ page will have a length equal to 66 single-spaced print lines (at six 

lines/inch, this gives the standard 11-inch page). The meaning and use 
of the other format parameters will be described later. 
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OVERVIEW OF PRINT MENU FUNCTIONS 

At the bottom of the screen is a new menu through which you can 
access the functions of the print system. Read the following brief 
descriptions, but don't try any functions yet, and don't worry about 
understanding them. 

FMAT (FORMAT) This is used to change the value of the format 
parameters listed near the top of the screen. 

PRINT (NORMAL PRINTING) This reads the text buffer, formats 
the text into print lines, and sends them to the printer. 

l-INK (LINKED PRINTING) This is an enhanced version of 
PRINT which allows continuous printing of a sequence of disk files. 

MERGE (MERGED PRINTING) This loads a utility program from 
The Writer's Tool disk which supports the printing of template 
documents merged with information from data base files. 

CHNGE (CHANGE PARAMETERS) This allows you to load special 
data files to change the current printer or to change the default 
print format and screen display characteristics. The name of the 
printer currently installed will appear just above the menu. The 
display now shows that the GENERIC printer is installed, providing 
a restricted print capability compatible with almost any printer. 

EDIT Pressing E returns program control to EDIT. 


WORDCOUNTER 

The number displayed after "WORDS is the number of words between 
the cursor and the end of the text currently in the text buffer. 
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PRINTING IN DEFAULT FORMAT 


Before going any further you should verify that the ATARI 850 
Interface Module is turned on, that your printer is turned on, and that 
your printer is selected (if it has a select button). Of course, you should 
also have the printer connected to the interface module and the 
interface module connected to the computer. [It's a good idea to turn 
your printer off and then on, to make sure it starts out in its default 
mode.] 

Once this is done, press P to start printing the text buffer. During 
printout you will see the following message in the command window: 


□AI1SE/ QRIItT EDIT EUIT PRIMT 


While this message is displayed, you can temporarily halt the printout 
by pressing P, then resume printing by pressing P a second time. 
Pressing Q aborts the printout and returns to the print system. 
Pressing E aborts the printout and returns to EDIT, with the cursor 
positioned at the first character of the last line printed. 


When the print process is completed, the Print System Menu will be 
redisplayed and you should have a printout that looks like this: 


Venus, the morning or euening star, is the third brightest 
object in the sky. Only the sun and moon are brighter. 

Venus has a thick atmosphere of carbon dioxide, with a 
surface pressure of 90 atmospheres, and a surface temperature of 
800 degrees Farenheit. 

Venus is surrounded by a cloud of concentrated sulfuric 
acid droplets which has a thickness of more than 10 miles. 


This was printed with the default format. The next example shows how 
to change the format. 

NOTE: If your text was all printed on one line, then your printer has 
not been properly configured for use with ATARI computers. Consult 
your printer manual to find out how to make your printer automatically 
perform a line feed after every carriage return. 
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CHANGING FORMATS FROM THE PRINT SYSTEM 


The following example uses text loaded from disk at the beginning of 
this section and assumes that the Print System screen is displayed. 

(1) Press F to activate the format changing routine. This will produce 
the following prompt: 


FNTFR FORMAT 


(Exattple; 


. mi 8 nnn > 


■ 


A format line starts with a period, ends with a carriage return, and has 
letters and numbers in between. The letters must be either upper or 
lower case letters standing for one of the format parameters, and the 
number (no longer than three digits) following each letter defines a new 
value for the corresponding format parameter. Spaces in the format 
line are ignored. Continue with the following steps to see how to use a 
format line. 

(2) In response to the prompt, enter '.M20L50',RETURN (skip the quo¬ 
tation marks and comma, but don't forget the leading period). 

(3) Now you should see the print screen redisplayed with LEFT 
MARGIN (M) set to 20 and LINE LENGTH (L) set to 50. To see the 
impact of these changes on the appearance of the print, press P. 

Shown below is one paragraph of the default printout, then the 
modified version just printed: 


DEFAULT: 


Venus, the morning or evening star, is the third brightest 
object in the sky. Only the sun and moon are brighter. 


MODIFIED 

VERSION: 


Venus, the morning or evening star, is the 
third brightest object in the sky. Only the sun 
and moon are brighter. 


Note that the print format parameters M and L have now returned to 
their original default values. More permanent format changes are 
possible using format lines imbedded within the text (explained in 
Section 6). 




TURNING OFF JUSTIFICATION 

In the last print example the right margin was straight, as well as the 
left margin. This is called right justification. The Writer's Tool does 
this automatically by inserting a few extra spaces between the words. 
If you would rather have equal spaces between words and don't mind a 
ragged right margin, then set the J parameter to 0 (enter 
'.JO',RETURN). 


WHERE TO FIND OUT MORE ABOUT FORMAT 

Now that you have some idea of what a format line is and how it works, 
you will be able to understand the more detailed discussion of format 
specifications presented in the REFERENCE GUIDE. Examples 
showing how to use most of the format functions are presented in 
Tutorial Section 6 (USING FORMAT CONTROLS). 


WHERE TO FIND OUT ABOUT OTHER PRINT SYSTEM FUNCTIONS 
The other print system functions are covered in Tutorial Sections 7-9. 
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5.5 CLEARING PART OF THE TEXT BUFFER 


This section assumes that you have the PDEMO file loaded into the 
text buffer. If not, go to Section 5.3 and load the PDEMO file before 
continuing. 

The CLEAR command allows you to delete text from the memory 
buffer. This method of deletion is mainly used to remove large 
amounts of text quickly. The following example shows how to remove 
everything but the second paragraph of the PDEMO file. 

(1) Go to EDIT and move the cursor to the beginning of the second 
paragraph. 

(2) Press OPTION to display the main menu. 


mm menu 

■SEARCH GJI5KI0 QUINT BLEAR EDIT 


(3) Press C to activate the CLEAR function. This will produce the 
prompt "CLEAR AFTER OR BEFORE CURSOR (A/B)?". 

(4) Enter 'B',RETURN. This will result in the second prompt "ARE 
YOU SURE (Y/N)?": 

CLEAR AFTER OR BEFORE CURSOR IA/B)?B 
ARE YOU SURE (Y/N>?| 


(5) Enter 'Y',RETURN. This will erase all text before the cursor, move 
the cursor and remaining text to the top of the text buffer, and 
finally return the program control back to EDIT. 

(6) Now move the cursor to the beginning of the new second paragraph. 

(7) Activate the clear function again: use OPTION to display the main 
menu, then press C. 

(8) This time answer the prompts with 'A',RETURN, then 'Y',RETURN. 
This will delete all text after (and at) the cursor position, leaving 
only one paragraph in the text buffer. This was originally the 
second paragraph of the PDEMO file. Thus, the objective stated at 
the beginning of this example is accomplished. 
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6.0 USING FORMAT CONTROLS 


The number of different ways the same words can be printed is almost 
unlimited. The character shapes and sizes, the length of printed lines, 
the space between lines, the number of lines per page, the numbering 
of pages, the style of headers and footers, and the justification and 
indentation of paragraphs are just a few of the numerous factors which 
can change the appearance of the printout. A specific choice of all 
these variables is what is meant here by the term format. 

The Writer's Tool automatically makes a choice of the format variables 
which produces reasonably good-looking printout on most printers. This 
section shows how to change the format to suit your own special 
purposes. 

You have already seen how to change print format by entering format 
lines from within the Print System. A more powerful technique uses 
format lines imbedded within the text itself. Imbedded format lines, 
together with imbedded header and footer blocks, and a few special 
format control characters, provide great flexibility in controlling 
format. 


6.1 IMBEDDED FORMAT LINES 

An imbedded format line is a format line placed within the text. To 
function there it must be a paragraph of its own. This means it must be 
preceded by a carriage return symbol (unless it's the first line in the 
buffer) and terminated by a carriage return symbol. 

EXAMPLE 

(1) Move the cursor to the beginning of the text buffer, CLEAR ail 
text, then load the file PDEMO from The Writer's Tool disk. Do 
this even if you already loaded PDEMO earlier. 

(2) Enter three format lines in the text as shown in the following 
screen display (use SHIFT-INSERT to make room for the additions, 
then start with a period and press RETURN at the end of each 
format line): 
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Format 

Lines 


SCREEN 

DISPLAY: 



.M8L58* 

Venus, the Morning or evening 
star, is the third brightest object in 
the sky. Only the sun and Moon are 
brighter.* 

Venus has a thick atMosphere of 
carbon dioxide, with a surface 
pressure of 98 atMOSpheres, and a 
surface teMperature of 888 degrees 
Farenheit.f 
.K8I5* 

Venus is surrounded by a cloud of 
concentrated sulfuric acid droplets 
which has a thickness of More that 18 
Miles.* 


(3) Move the cursor to the beginning of the text, then go to the Print 
System. Note on the Print System screen that M, L, and I have not 
been changed by the imbedded format lines. The print routine does 
not yet know about the imbedded commands. 

(4) Press P to produce the following printout: 


PRINT 

EXAMPLE: 


Venus, the morning or evening star, is the 
third brightest object in the sky. Only the sun 
and moon are brighter. 

Venus has a thick atmosphere of carbon 
dioxide, with a surface pressure of 90 
atmospheres, and a surface temperature of 800 
degrees Farenheit. 

Venus is surrounded by a cloud of 
concentrated sulfuric acid droplets which has 
a thickness of more than 10 miles. 


Here the line length is set to 50 (L50). The first and last paragraphs 
have the same margin (M0), but the last paragraph is indented (15). 
Note that the indents do not affect the right hand margin. The second 
paragraph has a different left margin (M5), which also affects the right 
margin. 




EXPLANATION 


Imagine that the printing program reads the text buffer much the way 
you would, a word at a time. As it reads the words, it copies them into 
a special place in memory called the line buffer. When it collects as 
many words as can be fit in the line buffer, it sends the line to the 
printer and then continues reading more words to make the next line. 

How long the line buffer is and how it's printed are determined by 
numbers stored in other places in the computer memory. These 
numbers are the format parameters. At the beginning and end of any 
print operation these memory locations contain the default format 
values. But these values can be changed by the imbedded format 
commands. 

While the program is reading through the text, it keeps an eye out for 
paragraphs that start with a period. These are interpreted as format 
commands. When it encounters a format line, it decodes the line and 
stores any new format parameters in memory (erasing the old values). 
It then reads on, looking for more words to print. The remaining text is 
printed using the revised format parameters, until another format line 
is encountered. Thus, imbedded commands have priority over formats 
entered from the print system. Even though you can change the 
parameter values using the FMAT command, these changes will be 
superceded during printout by whatever imbedded format statements 
appear in the text. 


IMPORTANT FACTS ABOUT IMBEDDED FORMAT LINES 

1. An imbedded format line must be a paragraph that starts with a 
period. 

2. Imbedded formats only affect the text which follows them. 

3. Imbedded formats take precedence over format commands entered 
from the print system. 

4. Printing halts when a bad format line is encountered. Control will 
then return to EDIT with the cursor positioned at the beginning of 
the bad format line. 
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6.2 CENTERING AND SPLITTING 

Centering titles and headings between left and right margins requires a 
special format line ('.C\RETURN) just before each line you want to 
center. Splitting a line requires a special character (backslash) to be 
inserted at the point where you want the line divided. The part of the 
line left of this point will be printed flush against the left margin, and 
the rest of the line will be printed flush against the right margin. Both 
centered and split lines must be shorter than the line length specified 
by the L parameter. 

To see how to use these functions, do the following: 

(1) Move the cursor to the beginning of the text and enter what's 
needed to produce the following screen display: 


Left edge\right edge* 

* 

Nov is the tiwe for all good wen to 
cotte to the aid of their country.* 

* 

.C* 

Text in the center* 


(2) Move the cursor to the beginning of the text and print the text 
buffer. The printout should look like this: 


Left edge right edge 

Now is the time for all good men to come to the aid of their 
country. 


Text in the center 


The backslash symbol is used to split a short text line so that the left 
side of the line is left justified, and the right side is right justified. 

The centering command is a format line with only one parameter (C) 
and no numbers. It will center only the text line immediately following 
the centering command. 
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6.3 USING TABS 


You can use tabs to align columns of text, and Indent or outdent the 
first line of a paragraph. Using tabs requires inserting special 
characters in the body of the text. To see how this works, begin with 
the following example. 

USING THE ESC KEY 

(1) Go to EDIT, delete all text, and put the cursor at the beginning. 

(2) Press the ESC key once. This has no visible effect. Now press the 
TAB key. This should produce a solid right-pointing triangle on the 
screen. Normally, pressing TAB would just move the cursor. By 
pressing ESC first, the command function of the keyboard keys is 
bypassed, and the key-ins are interpreted as characters instead of 
commands. Now clear the text and proceed to the next example. 

CONTROLLING PARAGRAPH INDENTATION WITH TABS 

(1) With the cursor at the beginning, enter text to produce the 
following screen display: 


. nOL f XT* 

12345678301234567898123456789812345678 

9812345678981234567898* 

* 

.L48M10T5* 

►This is a demonstration of using tabs 
to control the start of the first 
line of a paragraph.* 


(2) Move the cursor to the beginning of the text and print the buffer. 
This will produce an outdent on the first paragraph line: 

OUTDENT: 

123456789012345678901234567890123456789012345678901234567890 
This is a demonstration of using tabs to 
control the start of the first line of a 
paragraph. 

[The sixty numbers just above the paragraph show the column position 
of each character.] 
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(3) Now go to the second format line and change T5 to T10, making 
sure that nothing else is changed. Move the cursor to the beginning 
of the text and print the buffer again. This will make the first line 
flush with the rest of the paragraph: 


FLUSH: 

123456739012345678901234567890123456789012345678901234567890 
This is a demonstration of using tabs to 
control the start of the first line of a 
paragraph. 


(4) Go back to the second format line again and change T10 to T15. 
Move the cursor to the beginning and print this version to obtain a 
paragraph with the first line indented by 5 spaces from the left 
margin: 


INDENT: 

123456789012345678901234567830123456789012345678901234567890 
This is a demonstration of using 
tabs to control the start of the first 
line of a paragraph. 


IMPORTANT FACTS ABOUT TABS 

1. The column position of the first tab is controlled by an imbedded 
format command using the T and a 1 to 3 digit number following it. 
Additional tab columns can be set by appending a comma and 
number for each additional tab column up to a total of eight tabs 
(.T10.20 will set the first two tabs). 

2. To get the text to align with a tab position requires inserting a tab 
character in the body of the text (using ESC, TAB). 

3. Text following the tab character will begin printing at the next tab 
column to the right of the current print column. 

4. Pressing the TAB key without a preceding ESC only moves the EDIT 
cursor and has no format control function. 

The use of multiple tab settings to align multiple columns of text is 

shown by the following example. 
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USING TABS TO MAKE TABLES 


(1) Move the cursor to the beginning of the text, clear any old text, 
then enter new text to produce the following screen display: 


12345678901234567890123456789812345678 

9812345678901234567898* 

. 1110 * 

15EX 1AGE1WEIGHT* 
male 143 1166* 
male 127 1178* 

■ 


(2) Move the cursor to the beginning of the text and print the text 
buffer. The printed output should look like this: 


123456789012345678901234567890123456789012345678901234567890 
SEX AGE WEIGHT 

Male 43 166 

Male 27 178 


This example used the default tabs at columns 5, 10, and 20. Note that 
characters are printed in columns 6, 11, and 21. This offset makes 
margin and tab settings of the same value produce print in the same 
column. The next example shows how to change the tab columns. 

(3) Move the cursor to the beginning of the text. Then insert the 
format line '.T15,30,45', RETURN . 

(4) Move the cursor back to the beginning of the text and print this 
version: 


123456789012345678901234567890123456789012345678901234567890 


SEX 

AGE 

WEIGHT 

Male 

43 

166 

Male 

27 

178 


By changing the tab column settings you can thus change the format of 
the table without retyping the entries in the table, an obvious 
convenience. 




6.4 HEADERS AND FOOTERS 


A header is a block of text printed at the top of each page. A footer is 
a block of text printed at the bottom of each page. Both header and 
footer blocks are defined by imbedding them in the main text and 
surrounding them with special marker lines. Headers and footers can 
each have their own formats and can be any length, provided their total 
length doesn't exceed the page length. 

VERTICAL PAGE FORMAT EXAMPLE 

To illustrate how the vertical format of a printed page is determined, 
suppose that a 3-line header and a 2-line footer are defined. Further 
suppose that the page length is set to 12 (using P12 in a format line) 
and that the first footer line is set to line 9 (using B9 in a format line). 
Then the printed page will have the following vertical organization: 


Page 

Page 

Print 


Number 

Line 

Line 

Contents 

1 

1 

1 

Header line 1 

1 

2 

2 

Header line 2 

1 

3 

3 

Header line 3 

i 

4 

4 

Text line 1 

i 

5 

5 

Text line 2 

i 

6 

6 

Text line 3 

i 

7 

7 

Text line 4 

1 

8 

8 

Text line 5 

1 

9 

9 

Footer line 1 

1 

10 

10 

Footer line 2 

1 

11 

11 

Blank line 

i 

12 

12 

Blank line 

2 

1 

13 

Header line 1 

2 

2 

14 

Header line 2 

2 

3 

15 

Header line 3 

2 

4 

16 

Text line 6 

2 

5 

17 

Text line 7 

2 

6 

18 

Text line 8 

2 

7 

19 

Text line 9 

2 

8 

20 

Text line 10 

2 

9 

21 

Footer line 1 

2 

10 

22 

Footer line 2 

2 

11 

23 

Blank line 

2 

12 

24 

Blank line 
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This example shows a total of 24 printed lines. Since the page length is 
set to 12, this corresponds to two complete pages. The combination of 
B9 and pl2 format commands reserves four footer lines starting at line 
9 of each page. Since there are only two lines in the example footer, 
this produces two blank lines between the end of the footer and the 
beginning of the next page. If no footer were defined, then all four of 
the reserved lines would be blank. 

To produce blank lines between the header text and the main text, 
blank lines should be inserted in the header block. To produce blank 
lines between the end of the main text and the beginning of the footer 
text, blank lines should be inserted at the start of the footer block. 

As far as The Writer's Tool is concerned, the top of a page is wherever 
the print head happens to be when printing is started. You can adjust 
the header and footer blocks to account for whatever starting position 
is convenient. 

Now that you know how headers and footers are positioned on the 
printed page, you should be ready to learn how to use them. 

IMBEDDING A HEADER 

(1) Make sure that The Writer's Tool is in EDIT, then clear the text 
buffer. 

(2) Starting at the beginning of the text buffer, type in what's needed 
to produce the following screen display: 


:H* 

.D* 

This is line 1 of the header block* 
Left title\Right date 5-12-83* 

* 

:* 

.P18L58I10* 

This is the Main text, and will be 
printed after the header is printed. 

To show that headers repeat at the top 
of each page, without using a lot of 
paper, the page length was set to the 
ridiculous value of 10 lines, and the 
line length to 58 characters. The 
header block is always printed in the 
default forMat because of the '.D' 
coMMand at the beginning of the header 
block. * 

■ 




The ':H identifies the start of a header, and the ■*-' defines the 
end of the header. The header format (line length, font, etc.) will be 
printed the same as the main text unless a separate format command is 
placed within the header block (as in this example). A format defined 
within a header block only affects the header itself and has no affect 
on the format of the main text. 


(3) Move the cursor to the beginning of the text and print the text 
buffer. Your printout should look like this: 

This is line 1 of the header block 

Left title Right date 5-12-83 

This is the main text, and will be 
printed after the header is printed. To 
show that headers repeat at the top of 
each page, without using a lot of paper, 
the page length was set to the 
ridiculous value of 10 lines, and the 

This is line 1 of the header block 

Left title Right date 5-12-83 

line length to 50 characters. The 

header block is always printed in the 
default format because of the 1 .D* 
command at the beginning of the header 
block. 


The blank header line was used to produce a one-line margin between 
the header text and the main text (which begins on the 4th line of each 
page). The last line of the main text is printed on the 9th line, with the 
tenth line reserved for a possible one-line footer. 

SINGLE KEY-STROKE HEADER INSERTION 

To quickly insert a simplified header block, move the cursor to the 
point of insertion, then enter SHIFT-CTRL-H. You can then edit this 
block as needed. 
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IMBEDDING A FOOTER 


Although a header always starts at the first line of each page, the 
starting line of a footer is set by the 'B' format parameter. In the 
default format, B is set to line 56 on a page of 66 lines. If no footer 
block is defined, this provides a 10-line gap between pages. If a footer 
is defined then the margin between the end of one page and the start of 
another page depends on the contents of the footer. The next example 
shows how to use a footer. 

(1) Clear the text buffer, move the cursor to the beginning and enter 
text to produce the following screen display: 


:F* 

* 

.M6L46* 

This is line 2 of a 4-line footer.* 
FOOTER LIME3\Page 8* 


• * 

.P1B H16 L36 b7* , ... . 

This is the wain text, and will be 
printed before the footer is printed. 
The footer will start printing on the 
line number set by the '.B 1 format 
command. If the footer is too long to 
fit at the end of the page, then only 
the part that does fit will be 
printed. Formats defined within the 
footer block do not affect the format 
of the main text. If no format line 
is used within a footer block, then 
the footer block will have the same 
format as the main text.* 


The start of the footer block is indicated on the display screen by 
':F *■' and the end is marked with ':-*•'. The first footer line is blank 
to provide a one-line gap between the end of the text and the first 
printed footer line. [Note that this footer format is different from 
that of the main text.] The footer will start printing on line 9 of 
each page, and the main text on line 1. The # symbol (on the third 
line of the footer) will be replaced by the page number on printout. 




(2) Move the cursor to the beginning of the text buffer and print the 
buffer. Your printout should look like this: 


This is the main text which will be 
printed before the footer is 
printed. The footer will start 
printing on the line number set by 
the \6' format command. If the 
footer is too long to fit at the end 

This is line 2 of a 4-line footer 

FOOTER LIME 3 Page 1 

of the page, then only the part that 
does fit will be printed. Formats 
defined within the footer block do 
not affect the format of the main 
text. If no format line is used 
within a footer block, then the 

This is line 2 of a 4-line footer 

FOOTER LINE 3 Page 2 

footer block will have the same 
format as the main text. 


NOTE: The footer was not printed at the bottom of the last page 
because the text ended before the footer line was reached. To insure 
that a footer is printed on the bottom of the last page, a page eject 
command ('.E',RETURN) must be inserted at the end of the text. The 
use of page ejects is described in Tutorial Section 6.6. 
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MAKING THE FIRST PAGE DIFFERENT 


To make the best use of headers and footers (and format commands as 
well), it is important for you to understand the sequence of events 
described below. 

Recall that The Writer's Tool print formatting program reads through 
the text just far enough to compose one print line, then prints the line 
and continues reading. As it encounters special format commands, it 
interprets each command as it finds it, makes the necessary alterations 
in its table of format parameters, then continues reading again. When 
it encounters a header or footer block, it remembers two things: where 
the header or footer text is stored in the text buffer, and the fact that 
there is a header or footer. 

Before printing the first line of a page, the print program checks its 
memory to see if a header block has already been encountered. If it 
has, then the program prints the header before printing part of the 
main text. If not, then the main text is printed at the top of the page. 
If the program encounters a second header block, it forgets about the 
first header and remembers only the more recent one. 

To defer the start of header printing to the second page it is only 
necessary to make sure that there is some printable text just before 
the header is defined. [Blank lines preceding the imbedded header will 
also work.) You should try this by modifying the text left over from the 
previous example. 
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SUMMARY OF HEADER AND FOOTER USAGE 


1. A header is printed at the top of every page following its definition. 
If you want a header on the first page, make sure the header block 
appears first in the text file. 

2. A footer is printed starting at the line set by the '.Bnn' format 
command. The footer is printed on each page following its 
definition. 

3. A header is defined by an imbedded block of text starting with the 
marker line ':H',RETURN and ending with the marker line 

RETURN. 

4. A footer is defined by an imbedded block of text starting with 
'tF 1 ,RETURN and ending with RETURN. 

5. If more than one header or footer is imbedded in the text, only the 
last one affects the pages following it. 

6. Formats defined within a header or footer block have no effect on 
the main text. If no formats are set within a header or footer, they 
will have the same format as the main text. 

7. A simple header block can be inserted in the text by holding down 
both SHIFT and CTRL keys, then pressing H . 
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~'\ 6.5 PAGE NUMBERING 

Page numbers can appear in headers or footers, and may be left 
justified, centered, right justified, or placed anywhere within the 
header or footer text. The following example demonstrates most of 
these options. 

(1) Go to EDIT, clear the text buffer, and enter text to produce the 
following screen display: 


"A 


[The short page length of 10 lines is used to save paper and still let 
you see the page number advance from one page to the next.] 

(2) Move the cursor to the beginning of the text and print it. Wherever 
the # symbol appears within the header (or footer), the printout will 
contain the current page number. Your printout should look like the 
sample shown on the next page. 

[Note that the second header line in this sample has left and right 
sides reversed on page 2. This will happen on all even pages 
because of the alternate command ('.A',RETURN) preceding the 
split-justified line. This is useful if you are printing (or Xeroxing) 
on both sides of the paper and want page numbers to appear near 
the outer edge of each page.] 


: H* 

Page »\Pagett* 

.««■ 

chapter II\Page II-8* 
.C* 

Page » of 12* 

* 

:* 

.ispie* 

Text line 1* 

T2* 

T3* 

T4* 

T5* 

T&t 

17* 
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Page 1 


Page 1 

Chapter II 

Page 1 of 12 

Text line 1 

12 

T3 

T4 

-1- 

Page I1-1 

Page 2 


Page 2 

Page II-2 

Page 2 of 12 

T5 

T6 

T7 

-2- 

Chapter II 


(3) Go back to EDIT and at the beginning of the text buffer insert the 
format line '.NIOl'.RETURN (this will start page numbers at 101 
instead of 1). Move the cursor back to the beginning and print this 
version. 

(4) Return to EDIT and insert five RETURNS at the beginning of the 
text buffer. This will prevent printing of the header on the first 
page (five blank lines will replace it). 

(5) Move the cursor to the beginning of the text buffer and print again. 
Your printout should look the same as before except that no header 
will appear on the first page. 

IMPORTANT FACTS ABOUT PAGE NUMBERS 

1. Page numbers are produced on printout wherever a # symbol 
appears within a header or footer block. 

2. The starting page number can be set using the '.Nnn' command in a 
format line. 

3. The alternate command can be used with a split-justified line to put 
page numbers on the outer edge of double sided pages. 
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6.6 PAGE EJECTS 

The page eject command causes the printer to advance to the top of 
the next page. Its use is demonstrated in the following example. 

(1) Go to EDIT, clear the text buffer, and enter text to produce the 
following screen display: 


.P18+ 
Page i* 

• E* 

Page 2+ 

• E* 

Page 3* 



( 2 ) 


Move the cursor to the beginning of the 
buffer. Your printout should look like this: 


text and print the text 


Page 1 


Page 2 


Page 3 
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6.7 USING THE GROUP COMMAND 


The end of one page and the beginning of another (the page break) can 
often occur at awkward points in the text. For example, you may find 
a table heading at the bottom of page 3, and the rest of the table at 
the top of page 4. Or you may find a major section heading at the 
bottom of page 5, and the first paragraph of the section at the top of 
page 6. Even if your present version of a document prints without any 
awkward page breaks, they might appear after revising the document. 
Although these awkward page breaks can be avoided by inserting page 
ejects at appropriate points, you can handle this problem automatically 
using the group command (also known as a conditional page eject). 

The group command is an imbedded format line with one parameter, 
and has the form '.Gnn',RETURN. This causes the printer to advance 
to the next page unless there are nn lines remaining on the current 
page. Thus the nn print lines following this command will not be split 
between two pages. The following example demonstrates the use of 
the group command. 

(1) Go to EDIT, clear the text buffer, and enter text to produce the 
following screen display: 


:H* 

Page «:* 

:* 

.L48P8* 

This first paragraph takes up so 
Much space on the first page that onlg 
part of the second paragraph Kill be 
able to fit.* 

.64* 

A group coMNand preceding this 
paragraph Makes sure that at least the 
first several lines of this paragraph 
will appear on one page.* 


To save paper the page length is set to eight lines (,p8). There will be 
only seven lines per page available for main text (the eighth line is a 
blank footer line). By the time the first five lines are printed there 
will only be two lines available on the first page. The group command 
(set to four lines with .G4) will thus force the printer to advance to the 
next page. 
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(2) Move the cursor to the beginning of the text and print the buffer. 
Your printout should look like this: 


Page 1: 

This first paragraph takes up so 
much space on the first page that only 
part of the second paragraph will be 
able to fit. 


Page 2 : 

A group command preceding this 
paragraph makes sure that at least the 
first several print lines of this 
paragraph will appear on one page. 


(3) Go back to EDIT and change the group command to '.G2' instead of 

’.G4\ 

(4) Move the cursor to the beginning of the text and print the text. 
This time there is sufficient room for the grouped text to appear on 
the first page: 


Page 1: 

This first paragraph takes up so 
much space on the first page that only 
part of the second paragraph will be 
able to fit. 

A group command preceding this 
paragraph makes sure that at least the 

Page 2s 

first several print lines of this 
paragraph will appear on one page. 
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6.8 USING SOFT HYPHENS 

The readability of justified text is often marred by the large gaps 
between words. This problem is worst with short print lines and long 
words. The text can be made more readable by turning off 
justification. But this can produce very ragged right-hand margins. 
The best solution to both of these problems is to hyphenate long words 
so they can be split between two lines. 

Soft hyphens are marker characters indicating where a word can be 
split if needed. If a split is not needed, The Writer's Tool will ignore 
soft hyphens. 

EXAMPLE 

(1) Load the PDEIVIO file at the beginning of the text buffer, then 
delete all but the second paragraph. 

(2) Insert a format line which sets the line length to 50, then print the 
paragraph (and note the large gaps between words): 

Venus has a thick atmosphere of carbon 
dioxide, with a surface pressure of 90 
atmospheres, and a surface temperature of 800 
degrees Farenheit. 

(3) Use SHIFT-1 to insert soft hyphen markers (|) in the words diox|ide, 
atmospheres, and Faren|heit. Now print the paragraph again (and 
note the improved readability): 

Venus has a thick atmosphere of carbon diox¬ 
ide, with a surface pressure of 90 atmospheres, 
and a surface temperature of 800 degrees Faren¬ 
heit. 

(4) Now comes the best part. Insert the word very in front of the word 
thick, then print the paragraph once more: 

Venus has a very thick atmosphere of carbon 
dioxide, with a surface pressure of 90 atmo¬ 
spheres, and a surface temperature of 800 degrees 
Farenheit. 

Note how the soft hyphens get turned into printed hyphens only when 
needed to improve text readability. You can also use soft hyphens 
after hard hyphens without having double hyphens printed. 
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6.9 LINE SPACING 


The Writer's Tool allows four different settings of the vertical space 
between print lines. Within a format line preceding the text you want 
spaced, use 

51 for single-spaced lines (6 lines/inch) 

52 for double-spaced lines (3 lines/inch) 

and, for some printers (see Reference Section 6), you can also use 

53 for one-and-a-half spaced lines (4 lines/inch) 

54 for half-spaced lines (12 lines/inch) 

[Other spacings are also possible, though not as convenient; you can 
imbed direct printer controls to set any line spacing your printer is 
capable of (see Tutorial Section 11).] 

These spacings can be mixed in any way you want, without changing the 
length of the page, which is always measured in units of single spaced 
lines. 

The half-spaced mode is especially useful for laying out equations and 
diagrams. The following screen display shows one example (don't try it 
until you find out more about your specific printer capabilities): 


* 

* 

2 H +0 

2 2 

2 2 * 

—> 2 H 0* 
2* 



ft - B 

y 

2* 


2 

C* 

c x + --- 
z* 

>* 


When printed in half-space mode (S4), the result is this: 


2 Rj + 0 2 —> 2 H 2 0 
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6.10 JUSTIFICATION OPTIONS 


The Writer's Tool supports four different options for handling word 
breaks and alignment of the right-hand margin. These are all 
controlled by setting the J format parameter within a format line. To 
illustrate the effects of these options, the second paragraph of the 
PDEMO file is shown printed below for each option (all with a line 
length of 50). 


JO Justify off, ragged margins, word wrap on 

Venus has a thick atmosphere of carbon 
dioxide, with a surface pressure of 90 
atmospheres, and a surface temperature of 800 
degrees Farenheit. 


J1 Justify by full spaces, straight margins, word wrap on 

Venus has a thick atmosphere of carbon 
dioxide, with a surface pressure of 90 
atmospheres, and a surface temperature of 800 
degrees Farenheit. 


J2 Justify off, straight margins, word wrap off 


Venus has a thick atmosphere of carbon dioxid 
e, with a surface pressure of 90 atmospheres, and 
a surface temperature of 600 degrees Farenheit. 


J3 Justify by microspacing, straight margins, word wrap on 

Venus has a thick atmosphere of carbon 
dioxide, with a surface pressure of 90 
atmospheres, and a surface temperature of 800 
degrees Farenheit. 


NOTE; This last option is only possible with some printers (the 
COMREX CR-II, and OKIDATA Microline-92 are two examples). 
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6.11 USING PRINT PREVIEW 


The print preview function is controlled by the 'V format parameter, 
and is usually set from the print system rather than being placed in an 
imbedded format line. 

If V is set to a non-zero value (say n), then all printout for page 
numbers less than n will be sent to the screen display for preview; 
pages with numbers equal to n or greater will be printed on the 
printer. Thus V is the View-to-print transition page number. 

EXAMPLE 

(1) Clear the text buffer, then load the DEMO file from The Writer's 
Tool disk. 

(2) Move the cursor to the beginning of the text, then press 
SHIFT-CTRL-H to insert the simple header block. Edit the header 
block to remove the backslash character. 

(3) With the cursor at the beginning, go to the print system, press F, 
then enter '.V20',RETURN. This sets the stage for printing 
everything to the screen, since the DEMO file doesn't have page 
numbers as high as 20. 

(4) Press P, and watch what happens. The first 38 columns of each 
line of text will be shown on your display. Look for page numbers in 
the header blocks. 

(5) This time, after you press P to get the preview started, press it 
again to pause the preview. Do this a few times, ending up with a 
pause. 

(6) When you have the preview paused, take note of the first word on 
the last line printed to the screen. Now press E. This will return 
control to EDIT with the cursor positioned at the beginning of the 
first word of the last line previewed. This makes it easy to edit 
immediately any problems you see while previewing. 

(7) Move the cursor back to the beginning, then go to the print system 
and change V to a value of 2. Press P to preview page 1 and print 
starting on page 2. 

(8) Before leaving this section, reset V to zero, turning off the preview 
function. 
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HOW TO PRINT A SELECTED PAGE 


Set V to the number of the page you want printed, start the print 
process, and press Q when the page has been printed. If your printer 
stores characters before printing, you may have to push the select 
button on your printer at the end of the page. 

NOTES ABOUT PRINT PREVIEW 

The preview print to the screen does not show exactly what your 
printed output will look like. Its main functions are (1) to show where 
page breaks will occur and (2) to allow starting the print at any page. 
These functions alone will probably save you a significant amount of 
time and paper. You can also see which justified lines have large 
numbers of spaces inserted between words (these probably would 
benefit from hyphenating the first word on the following line). 

The preview will not show fractional line spaces, changes in the number 
of characters per inch, and most important, you can't see more than 
the first 38 or so characters of each line. 

In some cases you will see special characters in the preview that do not 
show up on printout. These are printer control characters, and are best 
ignored. 
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6.12 DOUBLE-COLUMN PRINTING 


Double-column printing is activated by setting the 'X' format 
parameter to a non-zero value and deactivated by resetting it to zero. 
The value of X is the number of spaces between the left and right 
columns. The horizontal width of each column is the same and is set by 
the 'L' format parameter (line length). 

In double-column mode, printing proceeds as follows: (1) the header is 
printed; (2) the first column of text is printed; (3) the paper is reversed 
to the beginning of the second column; (4) the second column is printed; 
and (5) the footer is printed. This sequence is designed for one header 
and footer spanning both columns, and does not allow double headers or 
footers. While the second column is printing, tabs are positioned as if 
the left edge of the page were shifted by the same amount as the 
column shift. 

The method of backing up the page depends on printer capabilities. 
Some printers (the C.ITOH PROWRITER and ATARI 825, for example) 
support reverse paper feeds. These can print double columns 
automatically. Others, like the EPSON MX-80, can only execute 
forward line feeds. In the latter case printing stops at the end of the 
first column, and a message is displayed requesting manual reversal of 
the paper. Once the paper is re-positioned, printing can be continued 
by pressing START. The manual mode can also be used with printers 
that don't require it, and may allow somewhat more accurate 
alignment of the two columns. 

SETTING UP THE FORMAT 

To obtain good looking double-column printout requires a carefully 
chosen set of format parameters. Line length (L), left margin (M), and 
the space between columns (X) are the three format parameters which 
are particularly important. Since headers and footers are not double 
printed, you will probably want to use longer line lengths in the header 
and footer blocks, so they can span both columns. 

For convenience, suppose you want to use the default format for both 
the header and the footer. The default format has a line length of 64 
and a ieft margin of 8. To obtain the same left and right margins in 
double column mode, and also allow for an 8-space margin between the 
two columns, the line length must be 28 characters (28+8+28=64). 
These parameters are used in the following example. 
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EXAMPLE OF DOUBLE-COLUMN PRINTING 


(1) Go to EDIT and clear the text buffer. 

(2) To set up the header, footer and formats, enter text to produce the 
following screen display at the beginning of the buffer: 


:H* 

,D* 

DOUBLE COLUMN HEADERXPAGE tt* 
* 

* 

s* 

:F* 

.D* 

* 

* 


.C* 

CENTERED FOOTER* 
:* 

.L28 X8 Ml* 


The last line is a format line setting each column width to 28 
characters and the spacing between columns to 8 spaces. The 'Wl' 
command forces manual page reversal, even if your printer does 
support reverse line feeds. 

(3) Make sure the cursor is still positioned just past the end of the text 
just entered. 

(4) Now go to the Disk I/O System and load the file DEMO from The 
Writer's Tool disk (this will save you the trouble of typing several 
pages of text). 

(5) When control automatically returns to EDIT, move the cursor to the 
beginning of the text buffer and go to the Print System. 

(6) Before proceeding any further, you should try to adjust the top of 
the paper in reference to some mark or fixture on the printer so 
that you will later be able to roll back the paper to the same 
position. [The alignment of the first and second columns depends on 
how well you can return the paper to its initial position.] 
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(7) Press P to execute the PRINT function. After printing the header 
and the first column you will see the following message displayed in 
the command window: 


MOVE PRINT HEAD TO TOP OF PAGE 
then press START to print 2nd COL 

(8) Now move the paper back to where it was just before step 7, then 
press START. This will print the second column, then the footer of 
page 1. At this point printing will again stop (because of the W1 
format setting), and you will see the message: 

PAGE DONE...PRESS START TO CONTINUE 

At this point your first page should look like this: 


DOUBLE-COLUPIN HEADER 

Man has tried again and 
again to harness the wind 
for his own pleasure and 
profit. He has built 
windmills which drive 
millstones or complicated 
electric generators, and he 
has constructed ships and 


Humphries believes that at 
least twenty-six different 
fulfilled before a tornado 
can develop. It is certain 


PAGE 1 

that extremely hot air must 
meet cold air before a 
tornado can be produced, and 
it is probable that the 
so-called jet streams also 
play an important part in 
their creation. 


stirred in a pot, rising 
higher up the sides the 
whirling motion pressed the 
air outwards leaving a 


CENTERED FOOTER 


(9) If you want to continue with the second page, position the paper as 
described in step 6, press START, and continue following the 
prompts until printing is completed. If you have seen enough 
already, just press OPTION to abort the print process. 
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SUMMARY OF DOUBLE-COLUMN PRINTING 


1. The format command 'Xnn' activates double-column printing with 
nn spaces between first and second columns. The command 'XO' 
turns off double-column printing. 

2. In double-column mode the line length format parameter (L) sets 
the width of each column (not the total width of both columns). 

3. Manual page reverse is required for printers that do not support 
reverse paper feeds. 

4. Headers and footers are not printed in double-column format. Their 
formats should be set to cover both columns. 
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7.0 USING SPECIAL PRINTER CAPABILITIES 


The Writer's Tool provides a convenient way to use special printer 
capabilities such as underlining, superscripts and subscripts, boldface, 
compressed print, proportional spacing, and more. You can easily 
control these print features, provided that special information about 
your printer is made available to the program. The needed information 
about command languages and personalities of most popular printers is 
stored on The Writer's Tool disk in special printer data files listed 
below: 


PRINTER FILE 

PRINTER NAME 

SIMILAR OR EQUIVALENT PRINTER 

AT825.PPP 

Atari 825 

Centronics 737, 739 

AT1025.PPP 

Atari 1025 


AT1027.PPP 

Atari 1027 


CRII.PPP 

COMREX CR-II 

Brother HR-15 

FXBO.PPP 

Epson FX-80 


GEM10X.PPP 

Gemini 10X 


GENERIC,PPP 

Simple driver for 
use with any printer 


ML82A.PPP 

Okidata flicroline B2A 


mL92.PPP 

Okidata Microline 92 


mxao.ppp 

Epson MX-SO 

Epson MX-100 

eixaoG.ppp 

Epson MX-80 with 
Graftrax-Plus 


MX80GS.PPP 

(same as above) 


NEC8023.PPP 

NEC 8023A-PC 


PROWRTR.PPP 

C.ITOH PROURITER 8510A-P 


RX80.PPP 

Epson RX-80 



If your printer is not listed in this table you probably should stick with 
the GENERIC print mode (in which case you can skip the rest of this 
section, although you should read Tutorial Section 11). 

The following subsections show how to install your printer data file and 
how to use your printer's capabilities. 
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7.1 INSTALLING A PRINTER DATA FILE 


The data file for your printer must be read by The Writer's Tool before 

you can conveniently use any special capabilities of your printer: 

(1) Go to the Print System and press C to activate the 
CHNGE function. You will then see the prompt: "INSERT DISK 
WITH CUSTOM FILE IN Dl, START WHEN READY or OPTION to 
QUIT". 

(2) In this case, insert The Writer's Tool disk and press START. This 
will first display a directory, then produce the prompt "LOAD 
WHICH FILE?". 

(3) The printer data files are those ending with 'PPP'. If you had an 
MX-80 with Graftrax-Pius, you would enter 'MX80G.PPP',RETURN. 
After entering the appropriate file name, the print system screen 
will be redisplayed, with the name of your printer now appearing 
after the word PRINTER. After the installation, The Writer's Tool 
will be able to support the special features of your printer. 

CHANGING THE DEFAULT PRINTER 

If you would like The Writer's Tool to automatically load your printer 

data file when the program itself is first loaded, then follow this 

procedure: 

(1) Use the Disk I/O System to LOAD your printer data file into the 
text buffer. Be sure not to modify this file in any way. 

(2) Remove the write-protect tab from The ’Writer's Tool disk, then 
re-insert The Writer's Tool disk into Drive #1. 

(3) Go to the disk system again and SAVE the contents of the text 
buffer using a new filename. The new name should be the same as 
the old one except that the extender should be PDF, instead of PPP. 

(4) Re-install the write-protect tab on The Writer's Tool disk. Now, 
when you first boot load The Writer's Tool, your printer name will 
appear on the print system screen. Try it. 
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7.2 USING DIFFERENT FONTS 


Strictly speaking, a font is a set of characters having specific shapes 
and sizes. Here, the shapes of the characters are not as important as 
the number of characters which can fit in a given length (the character 
pitch). 

The Writer's Tool can recognize five different primary fonts, and seven 
font modifiers, some of which may also affect character pitch. The 
detailed characteristics of each font and font modifier vary from 
printer to printer. For convenience, this general discussion will use 
two of the most popular printers as examples: the Epson MX-80 (with 
Graftrax Plus), and the C.1TOH Prowriter. The meaning of the fonts 
and font modifiers for other printers are presented in Reference 
Section 6. 


PRIMARY FONTS 

The five primary fonts which can be used with a C.ITOH PROWRITER 
are illustrated below: 


FONT 

FONT 



NUPIBER 

NAPE 

PITCH 

PROWRITER PRINT SAPPLE 

1 

PICA 

10 Char./Inch 

Pi ca 

2 

ELITE 

12 Char./Inch 

El ite 

3 

COPPRESSED 

17 Char./Inch 

Caipressed 

4 

PROPORTIONAL 

22.56 Spaces/Inch 

Proportional (T4> 

5 

SPACEO PROP. 

20 Spaces/Inch 

Proportional <f5) 


The pitches of the two proportional fonts are defined in spaces per inch 
because the number of proportional characters per inch depends on 
which characters are printed: an M takes up more space than an i. The 
spaced proportional font uses the same characters as font 4, but a 
small additional space is inserted between characters to make them 
more readable. 

The Epson MX-80 allows only PICA and COMPRESSED fonts. The 
fonts available with other printers are described in Reference Section 
6 . 
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SETTING FONTS IN FORMAT LINES 


The five primary fonts are selected with the 'Fn' command placed 
within a format line (V is the font number listed on the previous page). 
For example, you can use '.F3',RETURN to force text after the format 
line to be printed in the compressed font. 

ADJUSTING THE OTHER FORMAT PARAMETERS 

Because different fonts take up different amounts of space, when you 
change a font you may also need to change the left margin, line length, 
and possibly tabs and indents. 

If you want to calculate your own format parameters, it is important to 
note that most printers start printing about 1/4 inch from the left edge 
of the page. You should also realize that the left margin parameter 
used by The Writer's Tool sets the number of spaces from the printer 
starting point, and not from the edge of the page. Thus, if you want a 
one-inch left margin with a 10 CPI font, don't use an 'M10'. This would 
produce a margin of 1.25 inches: 1/4 inch printer offset + 1 inch from 
the 10 spaces produced with the'M10'command. Instead, you should 
use 'M8', giving a margin of 0.8 inches + 1/4 inch (from the offset), for 
a total of 1.05 inches. 

If you would rather not calculate your own format parameters, you can 
use those listed in the following table. Margins are calculated 
assuming that the printer starts 1/4 inch from the left edge of an 
8.5-inch wide page. In this table, RETURN at the end of each format 
line is denoted by <RET>. 


FONT 

PITCH 

Pica 

(10 CPI) 

Elite 

(12 CPI) 


Format lines 
for 1-inch margins 


.FI FIS L64 <RET> 
.F2 M9 L78 <RET> 
.F3 Ml 3 L110 <RET> 
.F4 Ml 7 LI 49 <RET> 
•FS Ml 5 LI 30 <R£T> 


Format lines 

for 1.5-inch margins 


• FI Ml 2 L56 <RET> 

• F2 Ml 5 L66 <RET> 
•F3 M21 L94 <RET> 
.F4 M28 LI 27 <RET> 
.FS M25 L110 <R£T> 


Compressed (17 CPI) 
Proportional (22.86 sp/in) 
Spaced Prop. (20 sp/in) 


NOTE: Recall that these formats are not available on all printers (see 
Reference Section 6). 
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FONT DEMONSTRATION 


(1) Go to EDIT and put the cursor at the beginning of the text buffer. 

(2) Insert The Writer's Tool disk in drive 1, and load the demonstration 
file FDEMO. 

(3) Enter the PRINT system and make sure that your printer is the one 
installed (if it isn't, then go back to Tutorial Section 7.1 and follow 
the installation procedure). 

(4) Make sure your printer and Interface Module are connected and 
turned on. Then press P to print the demonstration file. If you 
used a PROWRITER, or NEC8023, your printout will look like this: 


<.F1M20L40) Four score and seven years 
ago our fathers brought forth on this 
continent a new nation. 

<.F2M24L47> Four score and seven years ago our 
fathers brought forth on this continent a new 
nation. 

(.F3N24U?) Four score and seven years ago our fathers brought 
forth on this continent a new nation. 

(.F4M46L91) Four score and seven years ago our fathers 
brought forth on this continent a new nation. 

(.F5M40L80) Four score and seven years ago our 
fathers brought forth on this continent a new nation. 


The format settings for each paragraph are indicated in parentheses. 
In each case the left margin is about 2.25 inches and the line length 
about 4 inches. 

NOTE: If you used an MX-80 printer, your printout of Elite and 
Proportional fonts will not work properly. Since MX-80's cannot print 
these fonts, the default font will be printed instead. To avoid ugly 
results like this, don't try to use fonts that your printer can't print (see 
Reference Section 6.). 
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7.3 USING FONT MODIFIERS 


Besides setting different fonts within format lines, the appearance of 
the print can also be changed within a line of printed text by means of 
FONT MODIFIERS. These are special characters which act like 
start/stop switches marking the beginning and ending points of a 
particular print modification. 

MODIFICATIONS SUPPORTED BY THE WRITER'S TOOL 

The following table summarizes the seven font modifications supported 
by The Writer's Tool, including how to insert the modifier characters, 
and examples of what they look like on the screen and how they affect 


the printout. 




MODIFICATION 

Keyin to Insert 
Modifier Char. 

DISPLAY SAMPLE 

NX80G PRINT SAMPLE 

None 


Mornai 

Normal 

Emphasized 

SHFT-CTRL-E 

HeN phasizedB 

Emphasized 

Double-Strike 

SHFT-CTRL-D 

llDouble Strikell 

Doubl e-Stri l:e 

Italics 

SHFT-CTRL-I 

QltalicsB 

Italics 

Double-Width 

SHFT-CTRL-U 

BHideB 

i c:ff e* 

Underlining 

SHFT-CTRL-U 

_Underlined_ 

« ffi'.-er 1 i ned 

Superscript 

SHFT-CTRL--t 

At2t + Bt 2f 

A"- -► it 2 

Subscript 

SHFT-CTRL-+ 

Aii4 4 B ii j4 



In each of these examples, a special character was inserted just before 
and just after the modified word in order to produce the indicated 
modification. The 'DISPLAY' column shows how the special characters 
look on your monitor. The 'PRINT SAMPLE' column shows what effect 
they have when the text is printed on an MX-80 with Graftrax-Plus. To 
achieve the desired effect you must also have a printer which can 
support these modifications, [The GENERIC print mode, doesn't 
support any of the modifications.] 
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HOW TO INSERT MODIFIER CONTROLS 


The Writer's Tool provides special conveniences for inserting the font 
modifier characters in your text. The appropriate keystrokes to insert 
each modifier are shown on the previous page and discussed below. 

Modifiers can be inserted by pressing and holding down both CTRL and 
SHIFT keys, then pressing a letter or arrow key. The letter and arrow 
keys are easy to remember: E for Emphasized, D for Double-strike, 
I for Italics, W for double-WIDE, U for Underline, and the up and down 
arrow keys for superscripts and subscripts. The appearance of the 
special modifier character suggests their functions. For example, the 
inverse video exclamation mark clearly suggests Emphasized print, and 
the inverse video slash suggests the slant of Italic characters. The up 
and down arrow symbols are even more obvious indicators of their 
superscript and subscript functions. 

The font modifier characters can also be produced using a sequence of 
keystrokes. The inconvenient way to produce an inverse video 
exclamation mark is to press and release the INVERSE key, then enter 
SHIFT-!, then turn off the inverse function by pressing the 
INVERSE key again. To enter an up-arrow you can use the following 
sequence: ESC, then CTRL-[t], [These alternate methods will be 
needed if you want to find or modify these characters using the 
SEARCH system, since this system will not respond to the 
SHIFT-CTRL- key-ins.] 


IMPORTANT FACTS ABOUT FONT MODIFIERS 

1. Font modifiers are special characters used to start and stop a modi¬ 
fication in the appearance of printed text. 

2. Font modifiers should always be used in pairs. 

3. Not all modifiers can be used with all printers. 

4. The underline start/stop symbol (entered with SHFT-CTRL-U) is 
different from the underline character (entered with SHFT-[_J). 
Thus, if you want a fixed number of blank spaces underlined, just 
enter the appropriate number of underline characters. 
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8.0 LINKPR1NTING 


Linkprinting allows you to print an unlimited number of disk files as 
one continuous document. You can also print a mixture of text in 
memory with text on disk, just by inserting specially formatted 
linknames which identify the diskfile to be printed. The procedure for 
linkprinting is illustrated by the following example: 

(1) Make sure that The Writer's Tool disk is in drive #1. This disk 
contains a demonstration file (LDEMO) which is needed for this 
example. 

(2) Go to EDIT and enter the following text at the beginning of the 
buffer: 


<D1:LDEMORETURN 

THAT WAS PRINTED IN DEFAULT FORMAT. RETURN 
.I20RETURN 

NOW AN INDENTED VERSION IS PRINTED. RETURN 
<D1: LDEMORETURN 

The one-line paragraphs displayed as ^DhLDEMO*-' define links to the 
disk file Dl:LDEMO. The first character (<) alerts the printing 
program that a linkname is present. 

(3) Move the cursor to the beginning of the text buffer, then enter the 
Print System (but don't try printing yet). 

(4) Once the Print System screen is displayed, press L to start the 
LINKPRINT function. This will display the warning message: 

WARNING:Text now in memory may be 
modified by linked printing 
OK TO CONTINUE (Y/N)? 

In some cases you may want to save the text buffer on disk before 
printing. In this example, it's OK to destroy the text buffer. 

(5) Answer the prompt with 'Y',RETURN and the linkprinting will 
begin. During the printing you will see the message "Printing Link 
File Dl:LDEMO" displayed in the command window. 
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When linked printing is completed, your printout should look like 
this: 


This is the text stored in the LDEP10 file used to 
demonstrate linked printing. Since this file does not contain 
any imbedded format commands its print format is determined by 
whatever format commands preceded it. 

THAT WAS PRINTED IN DEFAULT FORMAT 

NOld AN INDENTED VERSION IS PRINTED 

This is the text stored in the LDEMQ 
file used to demonstrate linked printing. 

Since this file does not contain any 
imbedded format commands its print format is 
determined by whatever format commands 
preceded it. 

Here is what happened. The printing program read and printed text 
from the buffer until it found the linknarne. At this point, it deleted 
the part of the buffer which was already printed, then loaded 
DlrLDEMO into the text buffer, in front of the text which follows the 
first linknarne. Once loaded, the linkfile becomes part of the text 
buffer and printing continued until another linknarne was encountered. 
Again the printed part of the buffer was deleted and the new link file 
was loaded, in the same manner as before. Printing stops when the last 
character is printed. [The most recently defined format, and the 
header and footer lines are not erased by the linking process.] 

(6) Return to EDIT and note that the original text entered in step 2 is 
no longer in the buffer. 

SOME APPLICATIONS 

Suppose you want to print a copy of your recently revised history paper 
which you have split into five chapters each stored in a single diskfile 
and all on one disk. This could be done by entering the following into 
the text buffer: 

<P1:CHAP1RETURN 
<D1:CHAP2RETUKN 
<D1: CIIAP3RETURN 
<D1:CHAP4RETURN 
<D1:CHAP5RKTURN 
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Executing the LINKPRINT function would then print all five chapters. 
If you first saved the text buffer under the name 'Dl.-HIST.PAP', next 
time you wanted to print a complete copy of the paper you would only 
need to enter 

<D1:HIST.PAPRETURN 

and then execute the LINKPRINT function. This is an example of a 
nested link: the first link file contains links to other files. 

Suppose you send out a Christmas letter each year to a dozen different 
relatives. Most of each letter is the same general family news and 
some of each letter is personalized to each individual. 

An easy way to handle the Christmas letter problem is to vvrite all the 
common news and store it in a disk file (say Dl:COMNEWS), then link 
this into each individual letter in the following manner: 

Dear Uncle John,RETURN 
RETURN 

<D1:C0MNJ5WSRETURN 

RETURN 

By the way, we will be able to accept 
your invitation to spend the week following 
Christmas with you and Aunt Helen at Vail.RETURN 
RETURN 

Sincerely,RETURN 

These are just a few of many possible applications of the LINKPRINT 
function. 

IMPORTANT FACTS ABOUT LINKPRINTING 

1. A linkname is specified in a one-line paragraph starting with ’<• and 
followed by the name of a diskfile. The diskfile name must have the 
form Dn:NAME, where n refers to the drive number. 

2. In addition to the imbedded linkname, linked printing requires that 
the LINKPRINT function be selected from the Print System. 

3. The LINKPRINT function modifies the text buffer during the 
printing process. 
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9.0 USING THE MERGE SYSTEM 


The MERGE system allows you to print a merged document which 
combines a document template with information either entered from 
the keyboard or automatically read from a diskfile. The template 
might be a form letter which needs specific names and addresses to be 
filled in. The merge system can read a diskfile with names and 
addresses, fill them into the template, and print the result 
automatically. If you have only a few letters to send, then merged 
printing is not a great advantage. If you have a large number of letters 
to send, merged printing can be invaluable. 

The MERGE system also allows you to create a data base of 
information which is designed to match the requirements of a 
particular template. Creating a data base and producing merged 
printout both rely on the template document. The next section shows 
how to create a template. 


9.1 PREPARING A TEMPLATE 

A template is different from any other document in only one respect: it 
has entries which define the location and names of variables. Wherever 
you want a variable to appear, just type the name of the variable in 
inverse video. These inverse video names will be used by the merge 
system to prompt you when you create a data base, and will be 
displayed next to items read from the data base during the merged 
printing process. The names themselves do not become part of the 
data base. Work through the following steps to create a template 
which will be used in the following sections. 

(1) Go to EDIT and clear the text buffer. 

(2) In the following, [INV] stands for the INVERSE key (this is used to 
start and stop inverse video text entry). To create a template, type 
the following text into the buffer: 
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[INV]FULLNAME[INV]RETURN 
[INV]STREET[INV]RETURN 
[INVJCITY, ST ZIP[INV]RETURN 
RETURN 

Dear [INV]MR/MRS LNAME[INV]:RETURN 
RETURN 

Your subscription for [INV]MAGAZINE[INV] will 
run out with the [INV]MONTH, YEAR[INV] issue. 
Please remit $[INV]MAGCOST[INV] to renew your 
subscription.RETURN 
RETURN 

Sincerely,RETURN 

RETURN 

RETURN 

RETURN 

L. MiserRETURN 

Subscription DepartmentRETURN 
.ERETURN 


After entering this text, you should see the following screen display: 



m* 


MR/HRS LNAME 


: * 
for 


Dear 
«• 

Your subscription, 
run out with 
Please rewit 
subscription 
«■ 

Sincerely,* 

«■ 

«• 

«■ 

L. Miser* 

Subscription Departwent* 

.E«• 


will 




(3) You have now completed a template. Move the cursor to the 
beginning of the template, insert an initialized blank disk in drive 
#1, then save the template using the filename SUBLET. 
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9.2 CALLING UP THE MERGE SYSTEM 

(1) Go to the Print System, then press M to activate the MERGE 
system. This will produce the prompt 


WARNING: Text in Memory will be Erased. 
OK TO CONTINUE (Y/N)? 


(2) Answer the prompt with 'Y',RETURN to continue with the loading 
of the Merge System. This will produce a second prompt: 


INSERT Master Disk in Drive 1 
START WHEN READY or OPTION to QUIT. 


(3) After inserting The Writer's Tool disk, press START. This will load 
the merge system, after which you will see the Merge System 
Sign-on screen: 


MERGE SYSTEM 


DATA LABELS: DEFINED IN TEMPLATE 
DATA SOURCE: KEY-IN OR DISK 
DATA TARGET: MERGED PRINTOUT OR DISK 
FOR DIRECTORY 
TEMPLATE FILENAME?! 


DATA LABELS are the inverse-video names placed in the template 
document. The SOURCE of the data input can be either the keyboard 
or a diskfile containing data items in the same order as the labels. The 
TARGET (or destination) of the input data can be either (1) a printed 
document in which the data items will replace the labels, or (2) a 
diskfile which will contain just data items matching the data 
requirements of the template. Now go to the next section. 




9.3 PREPARING A DATA BASE 

DATA LABELS in the TEMPLATE document are used to prompt for 
data input in the creation of a data base. The following example 
assumes that you have already created the template document named 
SUBLET, and that you have the Merge System Sign-on screen displayed 
on your monitor. 

(1) Before Merge functions can be activated, you must define which 
template document should be used. Insert the disk containing the 
file SUBLET, then press RETURN, followed by 1 to obtain a 
directory for disk drive #1. After the directory you will again see 
the prompt "TEMPLATE FILENAME?" 

(2) After verifying that you have the right disk, answer this prompt by 
entering 'SUBLET',RETURN. After SUBLET is loaded, you will see 
another prompt: 

DATA SOURCE? KEYBOARD DISKFILE 


(3) Answer this prompt by pressing K. The next prompt will be 
DATA DESTINATION? PRINT APPEND CREATE 


(4) In this prompt "PRINT" means that the data input will be merged 
with the template and printed; "CREATE" means that the input 
data items will be stored in a new diskfile; and "APPEND" means 
that the input data will be added to the end of an already existing 
diskfile. For this example press C to create a new data base file. 
The next prompt will ask you to specify the name of the new 
diskfile: "DESTINATION FILENAME?" 

(5) Enter 'SUBDAT',RETURN as the name of the new data base file. 
Finally, you will be asked "VERIFY EACH DATA GROUP (Y/N)?" 

(6) Here "DATA GROUP" means one complete set of data items 
matching all the labels in the template. "VERIFY" means to accept 
or reject each data group just after completing it. On keyboard 
input, this gives you a chance to catch mistakes before they get 
written to your data base file. On diskfile input this allows you to 
select which data groups will be printed or written to another file. 
For this example, answer by pressing Y. 
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(7) This completes setting up the data base creation function. Now 
begins the data entry. Below the line saying "READY FOR DATA", 
you will see the first data label presented as a prompt for data 
input. Answer this prompt and the remaining prompts in this first 
group as indicated below: 


LABEL PROMPT YOUR ANSWER 


FULLNAME 

STREET 

CITY, ST ZIP 
MR/MRS LNAME 
MAGAZINE 
MONTH. YEAR 
MAGCOST 


Henry JonesRBTURN 

324 Willow StreetRETURN 

Madison, WI 53713RBTURN 

Mr. JonesRETURN 

Micro NewsRETURN 

March, 1984RETURN 

28.95RETURN 


(8) After the last entry is made you should see the following screen 
display: 


FOR DATA 
Hl?Henry Jones 

' Willow Street 
n?iiadison, HI 
|?hr. Jones 
ro News 
March, 1984 
.95 



53713 


BILE, EKIP, or EUIT AFTER FILING ? 


(9) The prompt at the bottom of the screen asks for verification, in 
this case press F to accept the data group and have it filed in the 
data base. Next you will be prompted for entry of another group of 
data items. This time make up your own entries, but when you get 
to the end of this second group, press Q to file the second group 
and quit. This completes the data base, and presents a new prompt: 




NEW TEMPLATE NEW DATA or ^UIT ? 

Press Q to return to the Print System. Your data base is now 
safely stored in the diskfile SUBDAT. 
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9.4 PRINTING A MERGED DOCUMENT 

This section assumes that you have already created a template called 

SUBLET and a data base called SUBDAT, and that you are in the Print 

System. 

(1) Press M, then follow the prompts needed to load the Merge System. 
When the Merge Sign-on screen is displayed, go to step (2). 

(2) Remove The Writer's Tool disk from drive #1 and insert your disk 
containing the SUBLET and SUBDAT files. 

(3) Answer the "TEMPLATE FILENAME?" prompt by entering 
'SUBLET', RETURN. 

(4) Answer the "DATA SOURCE?" prompt by pressing D. This means 
that data will be read from a diskfile. 

(5) When prompted for the filename of the data source, enter 
'SUBDAT', RETURN. This is the diskfile containing the data items 
to be merged with the template. If you had forgotten the filename, 
pressing just RETURN would have given you a chance to see a disk 
directory to jog your memory. 

(6) Answer the "DATA DESTINATION?" prompt by pressing P. This is 
needed to produce a merged printout. 

(7) Answer the "VERIFY?" prompt by pressing Y. You should then see 
the following screen display: 



Henry Jones 

324 Willow Street 

Madison, MI 53713 

Mr. Jones 

Micro Mews 

March, 1984 

28.95 


BRIM! EKIP or EUIT ? 
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(3) Make sure that your printer is turned on, selected, and connected. 
When your printer is ready, press P to produce merged printout of 
the first data group: 


Henry Jones 
324 Willow Street 
Madison, WI 53713 

Dear Mr. Jones: 

Your subscription for Micro News will run out with the 
March, 1984 issue. Please remit $28.95 to renew your 
subscription. 

Sincerely, 


L. Miser 

Subscription Department 


(9) After this printout is completed, the second data group will be read 
from the diskfile and displayed for your verification. You can print 
or skip this second group as you wish. When all of the data has been 
read from the data base file, you will see the message "REACHED 
END OF DATA FILE", and then the prompt for "NEW TEMPLATE, 
NEW DATA, or QUIT?". Press Q to return to the Print System. 
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9.5 MERGED PRINTING WITH KEYBOARD INPUT 


Producing merged printout directly from data entered from the 
keyboard requires only a slight change in the procedures followed in the 
previous section: you should press K when presented with the "DATA 
SOURCE?" prompt. Of course you will still need to specify a 
TEMPLATE FILENAME, and press P when presented with the "DATA 
DESTINATION?" prompt. 

9.6 INSERTING NON-PRINTING COMMENTS 

Any one-line paragraph which begins with an exclamation point will be 
treated as a comment and will not be printed by The Writer's Tool. If 
you make such a one-line comment a data label (by entering the text 
after the ! in inverse video), then whatever data you enter to replace 
that label will also not be printed. However, the data will be written 
to a diskfile when you create a data base. This provides a means by 
which you can place markers at the beginning of each data group. 
These markers will help you find your way around the data base file if 
you decide to edit the file using The Writer's Tool. 

If you made the first data item a comment, then entered * when 
prompted for that data, each group of items in your data base file 
would begin with a *. You could then use the search function of The 
Writer's Tool to quickly scan from one data group to the next. This 
would greatly simplify the editing of the data base. 

9.7 EDITING A DATA BASE FILE 

Once you create a data base file with the Merge System, you can edit 
the file with the EDIT system of the Writer's Tool. Just load the file 
into the text buffer, and proceed as usual. When you load a data base 
file, you will see that there is one line for each data item, but no 
marker to tell you when one data group ends and another begins. 
Usually this is obvious from the data items themselves. For editing 
convenience you may want to insert group markers using the procedure 
described in the previous section. 

IMPORTANT NOTE 

When editing a data base file, do not add or delete lines, unless you add 
or delete an entire group. If you change the number of lines within a 
group, the data will no longer be in phase with the template document 
and the data items following the error will be inserted in the wrong 
place. 
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9.8 REPEATED DATA ITEMS. 


All previous examples have used a template that requires a fixed 
number of data items. This also results in a data base with a fixed 
number of data items per group. The Writer's Tool can also support 
data bases with variable length groups. 

An example of a variable length data group is a typical invoice. 
Suppose you run a small mail order business and you want to keep track 
of each customer's order. You might want your data base to contain 
the following data items: 

customer's name 
customer's address 

description of ordered item #1 
unit price of ordered item #1 
quantity of ordered item #1 
price of total item #1 order 

description of ordered item #2 
unit price of ordered item #2 
quantity of ordered item #2 
price of total item #2 order 

total price of all ordered items 


This kind of data base presents a problem because the number of 
different kinds of items isn't the same for each customer. Dealing 
with this problem requires the following template structure: 


NAME LABEL 
ADDRESS LABEL 

—BEGIN REPEAT MARKER— 

DESCRIPTION LABEL 
UNIT PRICE LABEL 
QUANTITY LABEL 
SUBTOTAL LABEL 

—END OF REPEAT MARKER- 

TOTAL COST LABEL 
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The Merge System requires an Inverse-Video < to begin the repeat 
block and an Inverse-video » to end the repeat. When you prepare a 

data base using a template structure like this, you will see "-BEGIN 

REPEAT BLOCK—" at the beginning, and at the end you will see 
"R=REPEAT or C=CONTINUE". Entering r (or R) will cause the block 
to be repeated. Entering c (or C) will cause the merge function to 
move to the next item after the repeated block. The R's and C's will 
become part of the data base, so you can easily edit the data base to 
add or delete repeated items. 

9.9 ADDING TO A DATA BASE 

To add new data groups to the end of a previously created data base, 
choose the APPEND option when asked for the data destination. Then 
enter the filename of the old data base. The append operation will not 
destroy data already entered into the data base. 

If you keep adding to a data base, you eventually will create a data 
base that is too long to be edited by the EDIT system of The Writer's 
Tool. If you ever need to edit a large data base you will first have to 
break it into smaller files. This can be done as follows: use the large 
data base as a source, create a new file as the destination, then use 
verify to select which groups are copied from the source to the 
destination. 

If you want to add a new data item to a data base, you will have to use 
EDIT to insert an extra item in each data group, then add a 
corresponding data label to the template. 


T-82 





10.0 USING THE CUSTOMIZER PROGRAM 


The Writer's Tool disk contains a BASIC program (CUSTOM.BAS) which 
allows you to personalize The Writer's Tool to suit your own purposes 
and tastes. 

The customizer program presents lists of parameters and their original 
default values. You can select those you want to change, then alter 
them as desired. When you've finished making changes, your changes 
can be written to a disk file for later use by The Writer's Tool. 


10.1 LOADING THE CUSTOMIZER PROGRAM 

With your computer turned off, and your disk drive turned on, insert an 
ATARI BASIC cartridge in the left cartridge slot (the cartridge is not 
required if you are using an 800XL). Then insert The Writer's Tool disk 
in drive #1. 

Hold down the SELECT switch, then turn on your computer. Keep the 
SELECT switch depressed until you see the message "LOADING 
CUSTOMIZER PROGRAM". In about 15 seconds the program will sign 
on with a copyright notice. After about 10 seconds of initialization, 
the main menu will appear: 


THE WRITER'S TOOL CUSTOMIZER 


HftIN MENU 


> CHANGE FORMAT PARAMETERS 
CHANGE DISPLAY OR SOUND 
WRITE CUSTOM FILE 
READ CUSTOM FILE 

b>*mi an option, then 
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10.2 OPERATING THE CUSTOMIZER PROGRAM 


The main menu of the customizer contains four options: 

CHANGE FORMAT PARAMETERS This is for setting new default 
values of page length, line spacing, beginning footer line, font, 
single sheet option, line length, left margin, justify, and all tabs. 

CHANGE DISPLAY or SOUND This is used to change where beeps are 
sounded (console or monitor), the cursor flash period and brightness, 
the left screen margin (allows full 40 column display), the color and 
luminance (brightness) of the background, and the luminance of the 
characters. 

WRITE CUSTOM FILE This is for writing your selections into a disk 
file for later use by The Writer's Tool. 

READ CUSTOM FILE This allows you to read a previously created 
custom file which you can then modify using the commands listed 
above. 

To create a new custom file, you should first select one of the change 
options and press START. This will display a new screen containing a 
list of the parameters which can be modified, their original settings, 
and the current custom values that you may have set. You can select 
which parameter to modify by using the up and down arrow keys. To 
increase the parameter value press the right arrow key; to decrease its 
value press the left arrow key. 

When you've completed all your changes, press OPTION to return to 
the main menu, then SELECT and START the write option. You v/ill 
then be prompted to insert in drive #1 the disk on which you want the 
custom file written. 

Once you have the appropriate destination disk inserted, press 
START to continue to the next step. This will produce a request for an 
identifier (up to 8 characters long). [Since this identifier is part of a 
filename, it must contain only upper case letters and numbers, and 
start with a letter.] This identifier is not used by The Writer's Tool; it 
is only there to help you later distinguish one custom file from another. 
The CUSTOM program will add the extender ".FFF" which allows The 
Writer's Too! to identify it as a format file. 

NOTE: To return to The Writer's Tool program, remove the BASIC 
cartridge and then follow the usual load procedure. 
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10.3 HOW TO LOAD THE CUSTOM FORMAT FILE 


There are two ways in which The Writer's Tool can load a custom file: 

MANUAL LOAD: This method is best suited for occasional use. If you 
have a custom format file designed only for a certain kind of 
document, and you keep these documents on a separate disk, then you 
should write the custom file on this disk, and use the following 
procedure whenever you are working with this disk. 

(1) Go to the Print System, then press 'C' to activate the 
CHNGE function. This will produce the prompt: "INSERT DISK 
WITH CUSTOM FILE IN Dl, START WHEN READY or OPTION to 
QUIT". 

(2) At this point you should insert your disk containing the custom 
(.FFF) file which you want to load, then press START. This will 
produce a directory of the disk, followed by the request "LOAD 
WHICH FILE?" 

(3) Enter the name of your custom file (including the .FFF extender) 
then press RETURN to install the new default format parameters. 
Control will return to the Print System screen with the new default 
parameters displayed. 

AUTOMATIC LOAD: This method is best for loading parameters which 
you almost always want used. 

(1) Use The Writer's Tool Disk I/O System to load the '.FFF' file into 
the text buffer. Be careful not to modify the file in any way. 

(2) Remove the write-protect tab from The Writer's Tool disk, then put 
it back in drive 1. 

(3) Go back to the Disk I/O System and use the SAVE function to write 
the text buffer into a file with the extender '.FDF' [the first part of 
the name doesn't matter]. 

(4) Replace the write-protect tab on The Writer's Too! disk. Now, 
whenever you load The Writer's Tool, your custom default file will 
automatically be loaded also. 
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10.4 WHY USE THE CUSTOMIZING FEATURE? 


There are both practical and esthetic reasons for using the customizer 
feature. A few examples are listed below: 

TO SAVE TIME If you always use the same printer, and almost always 
use the same font and margin settings which are different from the 
original defaults, you can save yourself the time and trouble of 
entering format commands each time you start up the program. 

TO INCREASE EFFICIENCY If you are preparing a complex document 
with an unusual format, and many small insertions of a different 
format, you can avoid having to enter the unusual primary format 
every time you finish a text block with a modified format. Just create 
a custom default file that sets defaults to the unusual format. Then 
every time you need to reset it you can just use the '.D' command. 

TO REDUCE IRRITATION If you find the original cursor flash rate to 
be irritatingly fast, or you dislike hearing a beep every time a search 
target is located, why not slow down the cursor flash and send the 
sound to the monitor (where you can control the volume)? 
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11.0 USING DIRECT PRINTER COMMANDS 


Anyone reading this section probably already knows that computers and 
printers use a number code to represent characters. Most computers 
and printers adhere to the ASCII code (ASCII stands for American 
Standard Code for Information Interchange.) The ASCII code uses 
numbers between 32 and 126 for upper and lower case letters, 
punctuation marks, and numerals. Numbers between 0 and 31 are used 
for control functions. For example, 10 means "do a line feed" and 13 
means "do a carriage return". 

Many printers require one or more control codes, sometimes followed 
by character codes, to control special print functions. For example, a 
27 followed by a 71 will make an MX-SO start printing in the 
double-strike mode. This particular sequence is often written as 
ESC.'G', since 27 stands for the ASCII escape code (ESC) and 71 stands 
for an upper case G. 

The Writer's Tool will automatically send printer commands as needed 
to produce the formats, fonts, and font modifications you set using The 
Writer's Tool commands. However, there are occasions when you may 
want to issue your own printer commands directly: (1) your printer is 
not supported by The Writer's Tool, or (2) you want to use the graphics 
capabilities which some printers provide. 

The procedure for sending direct commands to your printer is as 
follows: (1) look up in your printer manual the decimal values of the 
codes you want to send; (2) look up in Appendix 1 the keystrokes needed 
to insert those codes in the text; and (3) surround the command codes 
with special marker characters produced by entering SHIFT-CTRL-P. 
The marker characters serve to fence off the code sequence and 
protect them from being treated as normal words by The Writer's Tool 
print formatting routines. Whatever is between these markers will be 
sent directly to the printer without modification. If these codes are 
not marked, The Writer's Tool tnay interpret them as font modifiers, 
may insert spacing commands between the control codes, and may 
erroneously allocate space for them on the print line, all undesirable 
effects. 

USING THE NULL CHARACTER 

The null character has a numeric value of zero, is produced by entering 
CTRL-1,] and is displayed as a heart. Printers usually ignore the null 
character completely; sending a null character to a printer usually is 
the same as not sending anything. The Writer's Tool, on the other 
hand, treats the null character as just another printable character. 
This difference in interpretation can be used to advantage. 
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When a protected control code sequence actually does use some space 
on the print line, The Writer's Tool will not properly account for it, 
since it ignores such protected sequences. To force The Writer's Tool 
to allocate space, you can just insert one or more null characters next 
to the protected codes. The Writer's Tool will think that the null 
characters are using space while it is actually the control sequence 
which is using it. The net effect is an agreement between program and 
printer on how much space is needed. 

EXAMPLE: USING PRINTER GRAPHICS 

Printer graphics can be inserted into printed text without greatly 
disturbing print formatting, provided proper use is made of the 
protection markers (entered with SHIFT-CTRL-P), and the null code 
(entered with CTRL-1,] and displayed as a heart). How they should be 
used is best explained by a graphics example. 

First, a bit map of the desired graphic symbol must be defined. The 
table below presents the bit map for the copyright symbol: 


Pin # 


Bit value 


7 oolllllloo 128 
6 oloooooolo 64 
5 loollllool 32 
4 lolooooool 16 
3 lolooooool 8 
2 loollllool 4 
1 oloooooolo 2 
0 oolllllloo 1 


12345678910 


In this diagram, the '1'symbols indicate dots to be printed (pins to be 
'fired'). The ten-byte sequence of numbers corresponding to this bit 
map is 60, 66, 153, 165, 165, 165, 165, 129, 66, 60. The first byte is the 
sum of 4+8+16+32, corresponding to the binary number 00111100, which 
results in the firing of print-head pins 2,3,4, and 5, needed to print the 
first column of the graphics symbol. 
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To create this symbol on the NEC 8023 or PROWRITER requires the 
following sequence of keystrokes: ESC, ESC, 'S', 'O', 'O', '1', 'O', '<', 
'B\ INVERSE CTRL-Y, INVERSE '%' (four times), INVERSE CTRL-A, 
'B', '<'. This sequence should be surrounded by SHFT-CTRL-P symbols 
to keep the print formatting routine from treating it as a sequence of 
16 printable characters. Since the graphics character will actually 
take about the space of one normal character, the last thing to do is 
insert a CTRL-1,] adjacent to the protected graphics sequence to tell 
the print formatter to count just one space. 

The above keystrokes should produce the following screen display: 


GRAPHICS 
PROTECTOR COmAND 


FtS00i0<B 


GRAPHICS 

OATA 


y.y.y.y. 


PROTECTOR NULL 

■ A / 

:B<r* 


The six characters following the first protector correspond to the codes 
which tell the printer to print ten graphics columns. The next ten 
characters represent the number codes of the ten columns of the bit 
map. 

When this graphics code sequence is mixed with normal text, and 
printed on a PROWRITER, the result can look like this: 


This is a demonstration of mixed text 
and graphics. The '©' symbol is supposed 
to be used on copyrighted material. But 
is not usually available on 
printers. 


Although the right margin isn't perfectly straight, the correction is 
reasonably close. The slight wander in the right margin occurs because 
this graphics symbol is a few dots wider than a normal character. 
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The Writer's Tool Version 2.0 


Copyright 1984 Madison Micro 


REFERENCE GUIDE 


This reference guide describes all of The Writer's Tool commands and 
subsystems: what they are, how to use them, and how they function. 
The reference guide is complete, but brief, and not introductory. It 
does not present the step-by-step examples which are found in the 
tutorial sections of the manual, and it assumes some familiarity with 
the terminology and concepts presented in the tutorial. If you are 
already familiar with word processing software, you may be able to use 
The Writer's Tool effectively just by consulting the reference guide. 
Most of you will find the tutorial to be a useful preliminary. 
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1.0 CONTENTS OF THE WRITER'S TOOL DISK 


The Writer's Tool disk files and their functions are as follows: 


DOS.SYS This is the file management portion of the DOS XL 

disk operating system (a product of OSS, Inc.), and is 
capable of supporting both single and full double 
density disk drives. 

AUTORUN.SYS This file automatically loads after DOS.SYS, and, in 
turn, loads and runs The Writer's Tool word 
processor or, if SELECT is pressed, it loads and runs 
the BASIC program CUSTOM.BAS. 

CUSTOM.BAS This BASIC program is used to create custom format 
files which later can be installed manually or auto¬ 
matically as the default format of The Writer's Tool. 

MERGE.OBJ This is an external subroutine of The Writer's Tool 
which assists in the creation of data bases and 
merged printing. 

Pname.PPP Each of these files contains specific information 

needed to make use of special printer capabilities. 

DEMO This file and the PDEMO, LDEMO, and FDEMO files 

contain text used in the TUTORIAL to demonstrate 
The Writer's Tool functions. 
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2.0 STARTUP PROCEDURES 


Part of The Writer's Tool is cartridge-resident and the remainder boot 
loads from disk. With your computer off and disk drive on (and ready), 
insert The Writer's Tool disk and cartridge and turn on your computer. 

After turn-on, DOS.SYS will be loaded first (this takes about 10 
seconds). Next AUTORUN.SYS will be loaded and executed. 

AUTORUN.SYS will first determine if the SELECT switch is pressed. 
If not, a sign-on message will be displayed while the word processing 
program is being loaded (this load takes about 20 seconds). As soon as 
the load is finished, a brief initialization sequence will be performed; 
then control will be transferred to The Writer's Tool EDIT system. As 
part of the initialization, custom printer (PDF extender) or format 
(FDF extender) files will be installed automatically if they are present 
on The Writer's Tool disk. 

If AUTORUN.SYS determines that the SELECT switch is pressed, then 
it will load and run the BASIC program CUSTOM.BAS. (If you are using 
an ATARI 800, a BASIC cartridge must be inserted before pressing 
SELECT.) 
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3.0 THE EDIT SYSTEM 


This is the initial operating mode and the central function of The 
Writer's Tool. EDIT provides for both text entry and screen-oriented 
text editing without mode changes. Text stored in your computer 
memory can be edited by moving the cursor to where a change is 
desired, then inserting, deleting, or typing new text over the old. 


3.1 TEXT ENTRY MODES 


There are two modes of text entry: type-over and insert. Each will 
remain active until the other is selected. 


CTRL-T Activates the TYPEOVER Mode. This is the default mode of 
text entry. The cursor position is indicated by flashing 
between a character and its inverse video representation, or 
by a flashing underline (you can switch between these two 
cursor options by pressing SELECT). The character at the 
cursor is replaced by the new character entered. When used 
in conjunction with SHIFT-INSERT or SHIFT-CTRL- 
INSERT (to insert space) and CTRL-J (to remove unused 
space), this is the fastest mode for inserting text near the 
beginning of a large text file. 

CTRL-I Activates the INSERT Mode. This mode uses a flashing 
vertical bar for the cursor. The character at the cursor and 
those to the right of the cursor are pushed forward as new 
characters are entered. This mode of entry becomes too 
slow for fast typing when there are more than several 
thousand characters after the cursor. 
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3.2 KEYBOARD CONTROL 


What happens when a key is struck depends on the state of the 
keyboard. The keyboard is normally in lower case mode, but can be 
changed to other modes and returned using the following controls. 


SHIFT-CAPS Locks the keyboard into upper case mode, and displays 
the message "CAPS LOCK" on the status line (bottom 
screen line). 


CAPS/LOWR Pressing this key returns the keyboard to lower case, 
and removes the "CAPS LOCK" message from the 
status line. 

INVERSE Pressing the ATARI logo key (on an 800) or the key with 
a triangle (on an 800XL) turns the INVERSE mode on 
and off. When it's on, inverse video characters are 
produced. This control is independent of the upper 
case/lower case control. When the INVERSE key is hit a 
warning beep will sound. While this mode is active, the 
message "INVERSE" will be displayed on the status line. 

CTRL-CAPS Exchanges cursor and unshifted functions on the arrow 
keys, and displays "CURSOR EXCH" on the status line. 
This allows cursor movement without pressing the 
CTRL key, but when this function is active you must use 
the CTRL key to enter V, , or '=' characters. 

Pressing CTRL-CAPS a second time restores normal 
functioning of the arrow keys. 

The display of keyboard status can be erased by entering 
SHFT-CLEAR and restored by entering CTRL-?. SHFT-CLEAR also 
turns off the INVERSE mode. 
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3.3 CURSOR MOVEMENT COMMANDS 


CTRL-M 

CTRL-H 

CTRL-tt] 

CTRL-[ + ] 

CTRL-B 

CTRL-E 

CTRL-A 

CTRL-Z 

CTRL-W 

CTRL-F 


Moves the cursor one character to the right. If the cursor 
starts at the end of screen line, it will move to the 
beginning of the next screen line. 

Moves the cursor one character to the left. If the cursor 
starts at the left margin, it will move to the last character 
of the screen line above the initial line. If the cursor is at 
the beginning of the text buffer, it won't move at all. 

Moves the cursor up one screen line. If the cursor starts at 
a horizontal position to the right of the end of the 
destination line, then it will move to the end of that line. If 
the cursor is at the beginning of the text buffer, it won't 
move at all. 

Moves the cursor down one screen line. If the cursor starts 
at a horizontal position to the right of the end of the 
destination line, then it will move to the end of that line. 

Moves cursor to the beginning of the text buffer and puts 
the first line of text at the top of the screen. 

Moves the cursor to the end of the text and puts the last 
line of text at the top of the screen. 

Moves the cursor to the beginning of the line. 

Moves the cursor to the end of the line. 

Moves the cursor to the next word. This command will skip 
the cursor past return symbols, comment lines, format 
command lines, and header and footer marker lines. 

Page Forward. If the cursor is at the bottom screen line, 
the text will move up twenty screen lines. If the cursor 
starts at some other position, this command will first move 
the cursor to the bottom screen line. If you attempt to page 
past the end of the entered text, the message "CURSOR 
PAST END OF TEXT" will appear and paging will not occur. 



CTRL-R Page Reverse. If the cursor is at the top of the screen, the 
text will move down 20 screen lines. If the cursor is not at 
the top, then this command will first move the cursor to the 
top screen line. 

TAB Moves the cursor to the next screen column which is a 
multiple of five. This is designed for fast cursor movement. 
To use imbedded tabs for controlling print format, see the 
section on special symbols. 


CTRL-S Continue search. Moves cursor to the next occurrence of 
the search string defined in the last use of the SEARCH 
subsystem. If no search string has been defined, this 
command will have no effect. 


ALTERNATE CURSOR MOVEMENT 


Another important method for cursor movement is by means of the 
SEARCH function. This is especially useful for finding a specific 
location in a long text file. 

The print preview can also be used to move the cursor. Pressing 
P during the preview will pause the preview. Pressing E after a pause 
will return control to EDIT with the cursor positioned on the first 
character of the last line printed to the screen. 
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3.4 DELETE COMMANDS 


CTRL-DELETE Deletes the character on which the cursor is 
positioned. The deleted character is replaced by the 
character to the right of the cursor. 

DELETE(BACK S) This deletes the character to the left of the cursor 
and moves the cursor one character to the left. In the 
type-over mode of text entry the deleted character is 
replaced by a space. In the insert mode the deleted 
character is replaced by the character immediately to 
the right of the deleted character. 

SHIFI'-DELETE Deletes the line on which the cursor resides. This 
command also produces a beep to warn against 
accidental repeats. The most recently deleted line can 
be "undeleted" by entering CTRL-U. 

SHFT-CTRL-DELETE Performs the same function as SHIFT-DELETE, 
but does not give a warning beep and is thus faster. 

CTRL-J Join command. This deletes spaces between the cursor 

and the next non-space character. This is primarily 
used to rejoin text that is split open by the 
SHIFT-INSERT or SHFT -CTRL-INSERT commands, 
after adding new text in the space opened. 

CTRL-X Deletes a previously marked block and the block 

markers (see BLOCK COMMANDS, Page R-10). 

Other ways to delete text are provided by the CLEAR and SEARCH 

functions (see Pages R-18, R-29 for explanation). 
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3.5 INSERT COMMANDS 


CTRL-INSERT Inserts a space between the character at the cursor and 
the character to the left of the cursor. 

SHIFT-INSERT Inserts a blank line on the screen. In the type-over 
mode a screen-line's worth of blank characters {usually 
38) is inserted between the character at the cursor and 
the character to the left of the cursor. The cursor is 
left positioned at the first of the inserted blanks. This 
is to be used to open up space for inserting new text. 
Extra space can then be removed using CTRL-J. In the 
insert inode this command just inserts a carriage 
return. 

SHFT-CTRL-INSERT Inserts all available space at the cursor position. 

Text after the cursor is moved as far forward as 
possible (all the way to the end of the memory buffer) 
to make room for large text inserts. This command is 
only effective in the type-over mode of text entry. 
After new text is entered, the unused space should be 
removed by placing the cursor at the beginning of the 
blank region and pressing CTRL-J to rejoin the text 
that was moved to the end of the buffer. NOTE: when 
text after the cursor is pushed to the end of the buffer, 
attempts to insert more space (using SHIFT-INSERT for 
example) will result in "OUT OF MEMORY" messages. 

CTRL-U This is the "UNDELETE" command. It inserts the last 

deleted line starting at the cursor position. 

SHFT-CTRL-H This inserts a header block and header markers in one 
keystroke. 

Another way to insert text is to use the insert mode of text entry 

(explained on Page R-4). 



3.6 BLOCK COMMANDS 


Blocks of text can be marked, then copied or deleted. To move a block 
of text, first mark it, then copy it to the new location, and finally 
delete the original. If you want to delete only block markers, move the 
cursor to the marker and press CTRL-DELETE, or use the 
/search/replace/ form '/INV-CTRL-R//'. 

CTRL-M Marks a block. This inserts a block marker symbol between 
the character at the cursor and the character to the left. 
When the first marker is inserted, all text beyond the marker 
will be displayed in inverse video. When the second mark is 
inserted, only text between the two marks will be highlighted 
in inverse video, provided both marks are on the screen. If 
only the second mark is on the screen the highlighting will 
not be correct. However, the action of block copy and 
delete functions will be correct independent of the screen 
display. A block marker cannot be inserted past the current 
end of text (this point can be found using CTRL-E). If you 
try to do so, the message "CURSOR PAST END OF TEXT" 
will be displayed on the status line. 

CTRL-C Copy a marked block. This command inserts a copy of the 
marked block between the cursor and the character to the 
left. The original block and its markers are not affected by 
this command. When using this command you may encounter 
one of four error messages, each accompanied by a buzzer. 
If the cursor is past the end of text, the message "CURSOR 
PAST END OF TEXT" will appear on the status line, and no 
copy will be inserted. If you try to insert a copy within the 
marked block itself, the message "CURSOR ERROR" will 
appear. If the text buffer is nearly full, there may not be 
enough room to insert another copy of the block. In this case 
"OUT OF MEMORY" will be displayed. If there are fewer 
than two block markers, the block is not defined. Trying to 
copy an undefined block will produce the message "MARKER 
ERROR" on the status line. If there are more than two block 
markers, the first two will be used to define the marked 
block and no error message will appear. 

CTRL-X Deletes marked block (and block markers). If less than two 
markers are present, the "MARKER ERROR" message will 
be displayed and no deletion will occur. If more than two 
markers are present, the first two will define the block to be 
deleted. For this command cursor position doesn't matter. 
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3.7 CASE CONVERSION COMMANDS 


These commands do not affect the state of the keyboard. They only 
act on text already entered. 

CTRL-K Converts to upper case (K sounds like C in CAPS). If the 
cursor is positioned at a lower case letter, the character will 
be converted to the upper case letter and the cursor will step 
forward to the next character. If the initial character is not 
a lower case letter, the cursor will merely advance to the 
next character. 

CTRL-L Converts to lower case. If the cursor is on an upper case 
letter, then the character will be replaced with the 
corresponding lower case letter and the cursor will step 
forward to the next character. Otherwise, the cursor will 
just step forward. 
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3.8 DISPLAY COMMANDS 


The EDIT display screen has 23 lines reserved for showing part of the 
text buffer, and one line (at the bottom of the screen) reserved for 
displaying status and error messages. The appearance of the screen 
display of text, cursor, and status information can be modified using 
the following commands (active only within the EDIT system): 

START Pressing this console switch toggles the word wrap function 
on and off. Turning off the word wrap is most useful for 
editing programs and other text files for which "words" are 
not the natural text unit. It is also useful for showing the 
exact number of spaces after the last word on a screen line. 
Another benefit to turning off the word-wrap function is that 
more text can be displayed on each screen line. 

SELECT Pressing this console switch toggles the type-over cursor 
between the inverse video cursor (the default mode) and the 
flashing underline cursor. This command does not affect the 
cursor used for the insert mode of text entry. 

SHIFT-CLEAR This erases whatever is displayed on the status line and 
turns off the INVERSE control if active. 

CTRL-? Restores the display of keyboard status at the bottom of the 
screen. 

In the default mode the screen lines can have no more than 38 
characters. This can be increased to 40 characters using the 
customizer program described in Reference Section 8. With the 
customizer program you will also be able to change the color and 
luminance of the screen background and the luminance of the 
characters displayed. 

If there is no keyboard entry for nine minutes, the display will enter 
the 'ATRACT' mode which produces periodic color and brightness 
changes designed to prevent burning in patterns on your TV monitor. 
Normal display colors will reappear when you use the keyboard again. 
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3.9 SPECIAL KEYS AND EDIT MODE FUNCTIONS 


RETURN Marks the end of a paragraph and is displayed as a left 
arrow. It also marks the end of both a print line and a screen 
line. When this key is pressed the cursor moves down to the 
beginning of the next line. The cursor cannot be positioned 
to the right of the RETURN symbol. 

SHIFT Hold this key down while pressing other keys to produce 
upper case letters or to activate secondary commands (shown 
at top of key legends). 

CTRL Hold this key down while pressing other keys to produce 
graphic characters, or activate command functions. 

TAB Causes cursor to move to the next screen tab column. (Tab 
columns are set at 5-space intervals and cannot be changed 
using tab SET or CLEAR functions.) To use tabs to control 
print format requires inserting the TAB character, 
accomplished by pressing ESC,TAB. 

ESC The escape key is used to insert characters in the text which 
would otherwise be interpreted as commands. For example, 
to insert the TAB symbol in the text, enter ESC,TAB. 
Without the initial ESC, the TAB would cause the cursor to 
move to the next tab column. To insert the escape character 
in the text, enter ESC.ESC. As these examples indicate, 
pressing ESC allows the next character to bypass the 
command interpreter. 

BREAK Has no effect in EDIT or any of the subsystems. 


Special keys used to control the keyboard are described in Reference 
Section 3.2 
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3.10 SPECIAL CHARACTERS 


The Writer's Tool reserves special characters for controlling printer 

output. You should avoid using these characters unless you want to 

invoke the print formatting functions associated with them. 

ESC.TAB Imbeds in the text a tab character (displayed as a right 
pointing triangle). On printout this causes the text following 
it to start one space beyond the next tab column set in the 
most recent print format line (see the PRINT system 
discussion for explanation of the format line). 

INV-ESC-CTRL-I Produces the same character as SHFT-CTRL-P (it 
looks like a fat filled-in 'P'). This symbol is used to delimit a 
printer control code or graphics sequence. During printout, 
characters between pairs of these symbols will be 
transmitted to the printer but will not be counted as 
printable characters in calculating line length or 

justification. The delimiting characters will not be sent to 
the printer. This allows you to send printer control codes 
without disturbing print formatting. It will be most useful if 
you do not have one of the specially supported printers. It 
can also be used (in conjunction with the null character) to 
insert printer graphics without disturbing print formatting. 

CTRL-[,] Produces the null character (displayed as a heart). This is not 
printed by the printer but is treated as a character by 
formatting routines. This is most useful for adjusting for the 
space used by inserted printer graphics. 

INV-ESC-CTRL-R This produces the same symbol inserted by the 
block mark command (a white rectangle with a horizontal 
bar through the middle). When searching for block markers 
you should search for the INV-CTRL-R character (you don't 
need to press escape when defining the search string). 

[.] When a period appears as the first text character, or the 

first character following a RETURN symbol, then the 
following paragraph is interpreted as a format line and will 
not be printed. 

[:] When a colon appears as the first text character, or the first 

character following a RETURN, the line which begins with 
the colon is interpreted as a marker line which delineates 
header and footer blocks (see Reference Section 5 for 
explanation of header and footer markers). 
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[!] When an exclamation point is the first text character or the 

first character following a RETURN, then the line which 
begins with the exclamation point is interpreted as a 
comment and will not be printed. 

[<] When the less-than symbol appears as the first text char¬ 

acter, or the first character after a RETURN, the following 
paragraph is interpreted as the name of a LINK file. If 
LINKPRINT is not active, the paragraph is printed. If LINK- 
PRINT is active, the named file will be loaded and printing 
will resume at the beginning of the newly loaded file. 

CTRL-N This produces the same symbol which starts and stops 
underlining during printout (it looks like a fat version of the 
normal underline character). This is usually inserted using 
the font modifier method as described below. 

[|] This vertical bar is used as the soft hyphen symbol. It marks 

the point where a word can be hyphenated at the end of a 
print line. 

[@] The format line RETURN will cause a print pause and 
the prompt "HIT ANY KEY TO CONTINUE". To avoid an 
inadvertant pause, don't start a paragraph with 

FONT MODIFIER CHARACTERS 

Seven special characters are used for font modifiers. To enter these 

characters most conveniently, hold down both SHIFT and CTRL keys, 

then 


press 

E 

to insert 

a 

(emphasize start/stop character) 

press 

D 

to insert 

ii 

(double-strike start/stop character) 

press 

I 

to insert 

a 

(italics start/stop character) 

press 

W 

to insert 

s 

(double-wide start/stop character) 

press 

U 

to insert 


(underline start/stop character) 

press 

W 

to insert 

t 

(superscript start/stop character) 

press [+] 

to insert 

+ 

(subscript start/stop character) 


Font modifiers should be used in pairs. Text between a pair of markers 
will be printed with the modification defined above. 
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3.11 EDIT USE OF CONSOLE SWITCHES 

The console switches are on the right side of the ATARI 800 and 800XL 

keyboards and at the top of the ATARI 1200XL keyboard. Their 

functions in the EDIT system are as follows: 

SYSTEM RESET Whenever this switch is pressed, the program halts 
whatever it's doing and returns control to EDIT. This does 
not affect text stored in memory or any of the system 
parameters. 

OPTION in EDIT, pressing OPTION will display the MAIN MENU 
which then provides access to other system functions. 

SELECT Toggles between the two possible type-over cursors 
(inverse-video and underline). 

START Toggles between two possible modes of text display: word 
wrap on or off. This does not affect the word wrap function 
on printout. 
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4.0 USING MAIN MENU FUNCTIONS 


4.1 THE MAIN MENU 


The MAIN MENU can be accessed from EDIT by pressing OPTION or 
entering CTRL-O. 

The MAIN MENU is displayed in a special text window of a different 
color and brightness than the main display. This window uses the last 
four lines of the screen. (This will be referred to as the "command 
window"). The MAIN MENU displays the names of the five functions: 
SEARCH, D1SKIO, PRINT, CLEAR, and EDIT. 

The first character of each function name is highlighted in inverse 
video representation. Pressing a letter key matching the first letter of 
the function name will activate the corresponding function. 

To leave the MAIN MENU and return to EDIT, press E. 

The MAIN MENU can only be called up from the EDIT system. 
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4.2 THE SEARCH SYSTEM 


Most search functions are accessed from the MAIN MENU (pressing 
OPTION or CTRL-O will display the main menu). 

When the MAIN MENU is displayed, pressing S first clears the menu, 
then produces the prompt "ENTER /Old/New/RETURN or 
/Old/RETURN". 

SEARCH AND REPLACE WITH VERIFY 

Old string and replacement string are entered in the form 
'/old/new/',RETURN. Here '/' is the delimiter character, which can be 
any character not present in the strings themselves. Starting at the 
cursor position, the search routine will find the first occurrence of 
'old', display it on the screen (with the cursor flashing at the first 
character), sound an alert beep, and then prompt for Replace, Skip, or 
Quit. 

If the 'S' key is pressed, no replacement will be made and the search 
will continue to the next occurrence. If the 'R' key is pressed, the new 
text will replace the old text, and the routine will search for the next 
occurrence of 'old'. If the 'Q' key is pressed, the routine will abort and 
return to EDIT without making a replacement. If some other key 
besides 'R', 'S', or 'Q' is pressed, the prompt will be repeated. 

The third delimiter is only needed if the last character of the 'new 
string' is a space. If the 'new' string is empty (no characters between 
2nd and 3rd delimiters) then the replacement function will have the 
effect of deleting the 'old' string. If the 'old string' is not found after 
the cursor, then a higher pitched beep will sound, the message "NOT 
FOUND" will be displayed briefly in the command window, and, after a 
short pause, control will return to EDIT. 

Pressing RETURN without specifying a search target will return 
control to EDIT. 

SEARCH ONLY 

If the initial prompt is answered in the form '/string/'RETURN, then 
the program will look for 'string' starting at the cursor position. If 
'string' is found, the cursor will be placed on the first letter of the 
'string', a low-pitched beep will sound, and control will return directly 
to EDIT. If 'string' cannot be found after the cursor, then a higher 
pitched beep will sound, the message "NOT FOUND" will appear 
briefly, and control will return to EDIT. In this mode of operation the 
2nd delimiter is only needed if 'string' ends with a space. 
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CONTINUE SEARCH 


Once the SEARCH function is used to define a search target (the old 
string), it is possible to continue searching for the same target directly 
from the EDIT system. Pressing CTRL-S will move the cursor to the 
next occurrence of the target string, sound the iow-pitched beep, and 
return to EDIT. If no further occurrence is found, then the higher 
pitched beep will sound, and the "NOT POUND" message will appear 
briefly on the status line. If no target string has been defined, this 
command will have no effect. 

WILD CHARACTERS 

The '?' character used within an 'old string' is treated as a wildcard 
character on search operations. For example, to replace both 'Figure' 
and 'figure' with 'Fig.', use '/?igure/Fig./',RETURN. 

COMMAND WINDOW EDITING 

The command window makes use of the built-in screen editor of the 
ATARI operating system. When this window is present, you cannot use 
most editing commands of The Writer’s Tool. However, you can move 
the cursor with CTRL-arrow and use single-character INSERT and 
DELETE functions. Another difference in text entry is that the 
command window does not support some of the special character entry 
keystrokes. For example, SHFT-CTRL-U will be ignored, and 
CTRL-M will not insert a block marker. Most important is that 
RETURN terminates string entry and begins the search process, rather 
than inserting a left arrow as it would in the EDIT system. 

SEARCHING FOR SPECIAL CHARACTERS 

Because of the different behavior of the command window noted above, 
special procedures are required to search for some of the special 
characters used by The Writer's Tool. It is sometimes desirable to 
search for format lines, which begin with a period following a carriage 
return. To search for the period-return symbol sequence, enter 
'/.'.ESC,CTRL-M,'/' as the '/old string/' part of the response (this 
should get displayed as /.+•/). To delete a block marker, enter 
'/INV-CTRL-R//'. 
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4.3 THE DISK I/O SYSTEM 


When the main menu is displayed, pressing 'D' will produce a new 
screen display: the main DISK SYSTEM screen. Commands available 
from the Disk I/O System are DIRECTORY (for drive or 2), LOAD, 
SAVE, DELETE, INITIALIZE, and EDIT. These are briefly explained at 
the top of the screen, and are also named in the command window at 
the bottom of the screen. Commands are activated by pressing a letter 
key matching the letter highlighted in the command window (usually 
the first letter of the command). You can return to EDIT by pressing 
E. The action of each Disk System command is explained in the 
following paragraphs. 

THE DIRECTORY COMMAND [J_ 2 (DIR)] 

This will clear the screen display, followed by a double-column display 
i of the disk directory for the selected drive. Press 'I' for a directory of 
the disk in drive 1, or press '2' for a directory of the disk in drive 2. If 
the directory has more than 36 filenames, the display will stop after 
the first 36 entries, and the prompt "PRESS ANY KEY TO CONTINUE" 
will appear. Pressing any key will then cause the remaining filenames 
to be listed. 

A PRINTED COPY of the directory can be produced by holding down 
the OPTION switch before pressingor'2'. Hold down OPTION until 
printing begins. 

THE LOAD COMMAND [LOAD] 

The LOAD command is started from the Disk I/O System by pressing 
'LL This is used to load text into the text memory buffer from a 
named disk file. 

The first prompt displayed when this command is started depends on 
the position of the cursor. Since text files are loaded into the buffer 
starting at the cursor position, this routine first checks to see if the 
text currently in the buffer will be overwritten. If the cursor is not 
past the end of the current text, then the message "WARNING: Load 
will overwrite current text (cursor thru textend)" will be followed by 
the prompt "OK TO CONTINUE (Y/N)?". If you want the file loaded 
anyway, respond with 'Y'.RETURN. Any other response will restore 
the Disk System command window, at which point you can go back to 
EDIT and reposition the cursor. 

If no warning was presented, or you ignored the warning, the next 
prompt will be "LOAD WHICH FILE?". To load file XXX from drive 
#1, you should respond by entering either 'XXX',RETURN or 
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'D1:XXX',RETURN. If the file is to be loaded from drive 2, then you 
must use the form D2:XXX. Failure to follow these conventions will 
result in error responses. If you enter a filename with the wrong 
format, a buzzer will sound and the prompt will be redisplayed. If the 
form is valid, but the file doesn't exist on the specified drive, the error 
will not be discovered until the load is attempted. 

After a filename in the proper format is entered, the prompt "ARE 
YOU SURE (Y/N)?" will appear. If you respond 'Y', RETURN, the 
routine will try to find the specified file. If the file is found, it will be 
loaded into memory starting at the cursor position. When the load is 
completed, a beep will sound and program control will return to EDIT. 

If the file cannot be found, a buzzer will sound, and an error message 
will be displayed briefly in the Disk System command window. If the 
file is found, but too large to fit into the available memory space, a 
warning message will be displayed in the command window. 

THE SAVE COMMAND [SAVE] 

This function will copy text from the memory buffer to a named 
diskfile. Only text from the cursor to the TEXTEND pointer will be 
saved. If the cursor is not at the beginning of the text buffer, the first 
action of this routine will be to sound a buzzer, display the message 
"WARNING: only part of the text buffer will be saved...", then present 
the prompt "OK TO CONTINUE (Y/N)?". If you really want to save 
only part of the text buffer, then answer 'Y', RETURN. Otherwise, 
enter 'N', RETURN or just RETURN (then go back to EDIT and 
reposition the cursor). 

If you have not previously loaded a file, the next prompt will be "SAVE 
TO WHICH FILE?". If you intend to save using the name ZZZ on drive 
#1, you can enter either 'ZZZ', RETURN or 'D1:ZZZ', RETURN. If you 
want the file saved on drive #2, you must use the form D2:ZZZ. If an 
invalid format is used for the filename, a buzzer will sound, and the 
prompt will be displayed again. 

After a valid filename is entered, the prompt "ARE YOU SURE (Y/N)?" 
will be displayed. This gives you a chance to change your mind; this is 
useful if you have made an erroneous entry in typing the filename. If 
you answer 'Y\ RETURN, the save will be attempted. If the save fails, 
a buzzer will sound, and an error message will be displayed in the 
command window. Explanation of possible disk errors is provided in 
Reference Section 7. 
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While the save is proceeding, the message "SAVING to—Dmfname" 
will be displayed in the command window. A successful save will be 
followed by a display of the directory of the disk on which the file was 
saved. 

If you have previously loaded a file, the name of the most recently 
loaded file will be used at the start of the save process. The message 
"Saving to—Dmfname" will be displayed, followed by the prompt "OK 
to continue (Y/N)?". Answer 'Y',RETURN if the displayed name is 
appropriate. If you enter a negative response, you will be asked to 
provide a filename as described in the previous paragraphs. 

THE DELETE COMMAND [DEL] 

This command will delete a specified file from a disk. This function 
will first produce the prompt "DELETE WHICH FILE?". To delete file 
EEE from drive #1 you can enter either 'EEE', RETURN or 'D1:EEE', 
RETURN. To delete file FFF from drive 2, you must use the form 
'D2:FFF'. After a valid filename is entered, the prompt "ARE YOU 
SURE (Y/N)?" will appear. If you answer with 'Y', RETURN, the 
deletion wil be attempted. If it fails, a buzzer will sound, and an error 
message will be displayed in the command window. 

THE INITIALIZE COMMAND UNIT] 

This dual purpose command is used either to initialize a disk drive (to 
set density), or to initialize a diskette (prepare a blank disk for data 
storage or erase an old disk). 

To initialize a diskette press I and then answer the prompt "WHICH 
DISK DRIVE (1 or 2)?" by entering the appropriate drive number, and 
pressing RETURN. The next display will present the options of setting 
density or initializing a diskette. Press I again, and verify your 
intention by answering the prompt "ARE YOU SURE (Y/N)?" (this 
function will completely erase the disk). If you answer 'Y'.RETURN, 
the message "INITIALIZING DISK" will be displayed and the process 
will begin. After about 40 seconds, the directory of the intialized disk 
will be displayed and control will return to the disk system command 
window. If you answered the previous prompt in any other way, the 
initialization operation would have aborted. 

To set the drive density, press I, select the drive number, then press 
D to set the drive to double density or S to set single density. (Please 
read Appendix 3 before attempting to use multiple disk densities.) If 
the density set command is successful, the message "Density Set OK" 
will appear. Otherwise you may see "Can't Set Density" (your drive 
won't respond to the command) or "Drive not available" (your drive 
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may be turned off or not connected). 

EXITING THE DISK I/O SYSTEM 

When the normal Disk System command window is displayed, you can 
return control to EDIT by pressing E. 

RULES FOR NAMING DISK FILES 

Disk files can be completely identified using the form 

Dn: FN AME. EXT 

where FNAME.EXT specifies the name of the file, and Dn: specifies 
which disk drive is to be used (n stands for 1, or 2). The drive specifier 
is not needed if you are addressing drive number 1. 
D1:FNAME.EXT and FNAME.EXT are equivalent forms. The only 
exception to this rule occurs in linked printing which always requires 
the drive specifier. 

The period separates the filename into a primary name and an 
extender. When you create a file, you do not need to specify an 
extender. If no extender is used, the period is also not needed. 

Rules for defining a filename are as follows: 

The maximum length of the primary name is 8 characters. 

The maximum length of an extender is 3 characters. 

Only upper case letters (A-Z) and numbers can be used. 

The first character must be a letter. 

DO NOT use the names DOS.SYS or AUTORUN.SYS. These are 
reserved for use by the disk operating system. 

When you identify an existing file, you can use wild card characters. A 
? denotes any character, and a * denotes any combination of 
characters. For example, LETTER.* identifies the first file that has a 
primary name of LETTER, while *.BAS identifies the first file with the 
extender BAS. The name L????R identifies the first file with a 
6-character name beginning with L and ending with R. 
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4.4 THE PRINT SYSTEM 


The Print System is selected from the main menu by pressing 'P'. This 
produces the Print System Screen which displays a two-column listing 
of the print format parameters, the word count between the cursor and 
the end of the text buffer, and the name of the current printer. At the 
bottom of the screen is the Print System Menu, displaying six 
commands: FMAT, PRINT, LINK, MERGE, CHNGE, and EDIT. 

Pressing 'P' at this point will print all text from the cursor forward, 
using the format parameters shown at the top of the screen (unless 
these are overridden by format commands imbedded in the text). 

Pressing 'E' will return control to the EDIT system. 

THE FORMAT COMMAND (FMAT) 

The print process will always begin using the format parameters 
displayed at the top of the Print System screen. These parameters can 
be changed within the Print System by pressing 'F' and responding to 
the prompt "ENTER FORMAT LINE". This prompt should be answered 
by entering an initial period followed by a sequence of letter codes and 
numbers, and terminated with a carriage return (RETURN). This is the 
same form as the imbedded format line described in Reference Section 
5. 

If you answer the "ENTER FORMAT LINE" prompt with a valid format 
line, the Print System screen will be redisplayed with the format 
parameters changed to the values specified in the format line. If you 
enter an incorrect format line, a buzzer will sound and the prompt will 
be repeated. Entering just RETURN will return to the main Print 
System Menu. 

Examples of legal format lines and their functions: 

•S2 mlO L40 Sets up double-spaced printing with a left margin of 10 
spaces and a print line of 40 characters. 

•T15,30,45j0 Sets first three tabs at 15, 30, and 45 spaces from the 
left most print position and turns off justification. 

•N10 Sets page numbering to start at 10 instead of the 

default value of 1 (printing a page number requires 
header or footer with # symbol imbedded in text). 
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Complete explanations of the format command structure and the 
meaning of the format parameters are presented in Reference Section 
5. 

NOTE; Format parameters entered from the PRINT subsystem only 
affect the initial format used by the print formatting routine. When 
this routine encounters a format line imbedded in the text, the 
imbedded command will take precedence. At the end of any print 
operation most format parameters will return to their original default 
values. Exceptions are the wait option (.Wn) and the view-to-print 
transition page setting (.Vn). 


THE PRINT COMMAND (PRINT) 

The PRINT command is activated by pressing 'P'. Printing will begin at 
the cursor position and end with the last character in the text buffer. 

Before printing anything, the print routine checks for the presence of 
initial format commands in the text. If format lines are found before 
any printable text, the format commands wili be interpreted first. The 
format of the header (if defined) and subsequent text will then be 
determined by the parameters (if any) present in these initial format 
commands. If the header or footer blocks themselves contain format 
lines, then their formats can be different from that of the main text. 

If the printer or interface module is not turned on, or if the printer is 
on but not selected (on line), a buzzer will sound and the message 
"DEVICE DOES NOT RESPOND, START TO RETRY or OPTION to 
QUIT" will be displayed. After correcting the printer or interface 
module conditions, press START to try again. 

Printing can be aborted after any print line by pressing Q (to return to 
the print subsystem) or E (to return directly to EDIT). Printing can be 
paused after any print line by pressing 'P' and resumed by pressing 'P' a 
second time. A message reminding you of these opportunities will be 
displayed in the command window during printing. 

When printing is completed, most format parameters will be returned 
to the default values. The page number will also be reset. 
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THE LINKPRINT COMMAND (LINK) 

An unlimited number of disk files can be continuously printed as one 
document by linking them together with specially formatted imbedded 
link names which point to the next file to be printed. To achieve this, 
each linkname must be part of a one-line paragraph of the form 
'<Dn:NEXT.PRN', RETURN, where n refers to the disk drive number (1 
or 2), and 'NEXT.PRN' should be replaced with the name of the next 
file in the print sequence. (The "<" character must immediately follow 
a carriage return.) An additional step is needed: in the Print System 'L' 
should be pressed to activate "LINKPRINT" rather than "PRINT". 

When LINKPRINT is started, the message "WARNING: Text now in 
memory may be modified by linked printing" will be followed by the 
prompt "OK TO CONTINUE (Y/N)?". If the buffer has already been 
saved, you can safely respond with Y,RETURN and printing will 
proceed. When all the text before the link line is printed, the named 
link file will be loaded from disk and inserted just before the remaining 
text. The text already printed will be erased (except for the most 
recently defined header and footer blocks) and printing will continue 
from the beginning of this new text until another link is found, or until 
all the text currently in memory is printed. 

As each new file is linked, the message "Printing Link file xxx" will be 
displayed (xxx denotes the name of the file being printed). If the linked 
file YYY cannot be found on the designated drive, the message "Cannot 
find—YYY, START ~> RETRY or OPTION ~> QUIT" will be 
displayed. At this point you should insert the disk containing the file 
YYY, then press START to continue the printing process. 

Linked printing can be paused by pressing 'P', resumed by pressing 'P' 
again, or aborted by pressing 'Q'. These are the same controls used to 
control normal printing. 

Linkprint Example: the text 

<D 1: ARTH. ADRRETURN 
RETURN 

Dear Arthur, RETURN 
<D I: XMAS. LET RETURN 
RETURN 

Sincerely,RETURN 

will print the address stored in disk file "DEARTH.ADR", then print 
the salutation, followed by whatever text is stored in the diskfile 
"Dl:XMAS.LET", and will finally print the closing. 
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THE MERGE COMMAND (MERGE) 

Pressing 'M' from the Print System will activate the Merge System. 
This is a sub-program which handles the creation of data base files, and 
the merged printing of these files with template documents. 

Before the Merge System can be loaded into memory, you must respond 
to the prompt "WARNING: Text in Memory will be Erased, OK to 
CONTINUE (Y/N)?" If nothing of value is in the text buffer, then 
answer 'Y'RETURN. This will produce another prompt: "Insert Master 
Disk in Drive 1, START when READY or OPTION to QUIT." Pressing 
OPTION will return control to the Print System with the text buffer 
still intact. 

After inserting The Writer's Tool disk as instructed, pressing 
START will load and run the MERGE.OBJ program. 

To use any Merge function, you must first identify a template file 
name. The template file contains text with data labels inserted at 
places where variables are to be used. (A data label is any contiguous 
string of inverse video characters.) 

A template is used to match data input to the data requirements. Data 
input must be in units of records (a text string terminated by a carriage 
return). The data source can be keyboard input or a named disk file. 
The data destination can be the printer (as a merged document), or a 
disk file (a series of records forming a data base). 

During data input it is possible to verify each complete group of data 
items before they are merge printed or added to a data base. During 
keyboard input the data labels are used to prompt for the desired data 
item in the order required. During disk input, the labels are shown next 
to the input data items to aid in verifying (it is possible to skip 
complete groups, if desired). 

Whenever a filename is requested by the Merge System, pressing 
RETURN can be used to get a disk directory or to quit the Merge 
System. Quitting the Merge System will return control to the Print 
System. 

Template files can only be created or edited using the EDIT System. 
Data base files are most easily created with the Merge System, but can 
be created and edited with the EDIT system (as long as the order and 
numbp'- of each group of data items matches the requirements of the 
template). 

Tutorial Section 9 provides detailed examples of how to use the Merge 
System. 
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THE CHANGE COMMAND (CHNGE) 

This command is used to install a new printer driver or a custom file 
defining a new set of default formats. Pressing 'C' will produce the 
prompt "INSERT DISK WITH CUSTOM FILE IN Dl, START WHEN 
READY or OPTION to QUIT. Pressing OPTION at this point will return 
to the Print System menu. Pressing START will display the directory 
of the disk in Drive 1, then ask "LOAD WHICH FILE?". There are two 
kinds of files which can be loaded: (1) Printer Data files (one of the 
files with a ".PPP" extender on The Writer's Tool disk), or (2) a custom 
format file written by the CUSTOM.BAS program (these files have 
".FFF" extender). Entering an invalid filename will produce the 
message "BAD FILE NAME", and return to the Print System Menu. 

After loading a printer data file or custom format file, program control 
will return to the Print System, with a new printer name or new default 
format parameters displayed, depending on which type of file is loaded. 

PREVIEW PRINTING TO THE SCREEN 

Before printing text on paper, you may want to check the position of 
page breaks, and verify that the format commands imbedded in the 
text are valid. This can be done by previewing text on the screen. 

To direct print output to the screen, set the 'V' format parameter to a 
value greater than the number of the last page to be printed. After 
this is done, executing either "PRINT" or "LINKPR1NT" will display the 
first 38 characters of each print line. The number of leading blanks on 
each line will equal the difference between the left margin and the 
first tab column. 

The screen preview scrolls rather rapidly. You can pause the preview 
by pressing 'P' and resume the preview by pressing 'P' a second time. 
The preview can be aborted by pressing either 'Q' (to return to the 
Print System) or 'E' (to return to EDIT with the cursor positioned at 
the beginning of the last line previewed. 

The preview does not always display the correct top and bottom 
margins unless you have the GENERIC printer selected. Fractional line 
feeds, proportional spacing, superscripts and subscripts, font 
modifications, and other special print format functions are also not 
shown as they would appear on paper. In spite of these limitations, you 
will find the screen preview a useful and paper-saving function. 

If the 'W' format parameter is set to 1 (the single sheet option), the 
preview will scroll through one page at a time, waiting for 
START after each page before proceeding with the next page. 
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PRINTING FROM THE MIDDLE OF A DOCUMENT 


Printing starts from wherever the cursor is positioned. This allows 
printing from any point in the text. However, this may not produce the 
desired print format. Proper page breaks and format changes cannot 
be accounted for unless the print routines have read through the 
document from the beginning. 

To print a properly formatted page in the middle of the document, set 
the cursor to the beginning of the text, go to the print system, set the 
'V' format parameter to the number of the first page you want printed, 
then execute "PRINT". All formatted output prior to this page will be 
directed to the screen, and all formatted output from the selected page 
forward will be sent to the printer. 


4.5 THE CLEAR SYSTEM 

The CLEAR system can be activated from the Main Menu by pressing 
C. It's function is rapid clearing of large amounts of text from the 
text buffer. 

This command first produces the prompt "CLEAR BEFORE OR AFTER 
CURSOR (3/A)?". Here "AFTER" actually means "at and after". 
Respond by answering 'B',RETURN or 'A',RETURN. This will produce 
the prompt "ARE YOU SURE (Y/N)?". If you answer 'Y'.RETURN, 
then the appropriate part of the text will be cleared. After the clear is 
finished, control will return to EDIT. Otherwise, clear will be aborted 
and control will return to EDIT. 
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5.0 GUIDE TO PRINT FORMAT 


This section describes how to control the appearance of printed text 
using The Writer's Tool format commands. These commands are only 
needed if you want to deviate from the default format. 

Format control is achieved through two primary mechanisms: format 
lines (usually imbedded in the text), which affect the appearance of at 
least one line of printout, and imbedded format characters, which may 
affect as little as one character in a line of printout. These two 
methods can be combined to provide an almost unlimited variety of 
printed formats. 

5.1 THE STRUCTURE OF THE PRINTED PAGE 

Within each page. The Writer's Tool recognizes three sub-units, each of 
which may have its own unique format. These sub-units are (1) the 
header block, (2) the main text block, and (3) the footer block. The 
header and footer blocks generally contain the same text on each page 
(except for the page number), while the content of the main text block 
changes from page to page. 

VERTICAL PAGE FORMAT 

The Writer's Tool begins its page wherever the print head happens to be 
when the print command is issued. This may or may not be at the top 
edge of the paper. It all depends on how you adjusted the paper and 
how your printer works (some printers can't print at the top of the 
paper). Thus, The Writer's Tool page may be vertically offset from the 
'physical' page (the boundaries of the sheets of paper, or the 
perforations). As long as you are aware of this offset, it shouldn't 
present any problems. Just remember to start printing with the paper 
adjusted to a convenient and consistent position. 

If a header has been defined, the first thing printed will be the header 
block. If a header has not been defined, the main text block will be 
printed first. 

The number of print lines used by the header block is determined by the 
header block itself. 

When the header is done printing, The Writer's Tool will begin printing 
the main text block. This will continue until the footer line is reached 
(this is line 56 in the default format). At this point, if a footer has 
been defined, The Writer's Tool will begin printing a footer. After the 
footer is printed, the paper will be advanced to the beginning of the 
next page. If the footer is longer than the space between the footer 
line and the beginning of the next page, then only part of the footer 
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will be printed. If no footer is defined, the footer line will be blank, 
and the paper will be advanced to the beginning of the next page. 

The most important factors controlling the vertical page format are 
these: 

(1) the starting position of the print head; 

(2) the number of lines used by the header; 

(3) the starting line of the footer (the value of the B format 
parameter); 

(4) the page length (the value of the P format parameter); and 

(5) the line spacing used within each sub-unit (the value of the 
S format parameter set within each block). 


DIAGRAM OF VERTICAL PAGE FORMAT 
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To produce blank lines between the header text and the first line of the 
main text, these blank lines must be specified within the header block. 
In similar fashion, initial blank lines in the footer block will produce a 
margin between the end of the main text and the footer text. 

NOTE: If you start with a large vertical offset of the print head, you 
should make sure that the footer block is short enough (or starts high 
enough) to avoid printing across the end of the physical page. 

HORIZONTAL PAGE FORMAT 

The left edge of The Writer's Tool page is determined by the leftmost 
position of the print head (for most printers this is usually 1/4 inch 
from the left edge of the physical page). This leftmost print position 
corresponds to a left margin of zero (set by the M format parameter). 
This is also the point from which tab columns are measured. The main 
factors controlling the horizontal format are the following: 

(1) The left margin setting (M) which is the number of spaces before 
the first printed character in a line. 

(2) The line length (set by the L parameter) which is the number of 
spaces beyond the left margin which are alloted for printed 
characters. 

(3) The indent (set by the I format parameter). This is a relative shift 
of the left margin from the margin set by the M parameter. It 
does not affect the right margin. 

(4) The font setting (determined by the F format parameter). Since 
different fonts take up different horizontal space, the physical 
length of the margin, print line, and indent can vary considerably 
even when their numeric values expressed in spaces is fixed. 

(5) Tab settings and imbedded tab characters. Tab columns are 
measured in spaces from the leftmost print position. When a tab 
character is encountered in the text, the print head will be moved 
to the next tab column before printing the next character. 

(6) Double-column spacing (controlled by the X format parameter). If 
the double-column spacing is set to zero, printout will be in single 
column mode. If the spacing is non-zero, two columns will be 
printed, each column having the same line length set by the 
L parameter. Thus, double column printing requires smaller line 
lengths than single column printing. 
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The factors controlling horizontal page format are illustrated in the 
following two diagrams. 


FORMAT DIAGRAM FOR SINGLE-COLUMN PRINTING 
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5.2 FORMAT COMMANDS 


Two kinds of commands are used: format lines and special characters. 
Format lines are usually imbedded within the text, but may also be 
entered from the Print System. Imbedded commands always take 
precedence over entered commands. 

FORMAT LINE COMMAND STRUCTURE 

An imbedded format command line is a separate paragraph preceded by 
a carriage return and terminated by a carriage return. The first 
character of the format line must be a period. The rest of the line 
consists of letters, spaces, and one to three digit numbers (and commas 
in the case of the tab command). Either upper or lower case letters can 
be used, and spaces are ignored. 

EXAMPLE: '.M8L55 p66 RETURN' sets the left margin to 8 spaces, 
line length to 55 characters, and page length to 66 single-spaced lines. 

Format lines entered from the Print System should have the same form 
as imbedded format lines. 

Unless noted otherwise, the following format commands can be 
combined into one format line (using only one period at the beginning 
of the line). 

COMMANDS AFFECTING VERTICAL FORMAT 

.Pnnn Sets page length to nnn (the number of single-spaced lines per 
page) The default value is 66, corresponding to an 11-inch 
page with six single-spaced lines per Inch. The page length 
should always be less than 127. 

.Sn Sets line spacing parameter to n (n=l for single spacing, n=2 
for double spacing, n=3 for 1.5 spaces per line, n=4 for 
half-spacing). The default value is n=l. 

.Bnnn Sets beginning line of the footer block to the nnnth line of the 
page, where nnn is a number less than 127. The default value 
Is 56. If you try to set B to a value greater than P, The 
Writer's Tool will force B to equal P. 

.Gnn Groups next nn print lines on a single page. This must be 
isolated on a separate format line. On printout, the text 
following this command will be printed on the next page, 
unless there are nn single-spaced lines left on the current 
page. 
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.E 


Page Eject (use by itself on a separate line). This advances the 
paper to the footer line, prints the footer, then advances the 
paper to the beginning of the following page. 


COMMANDS AFFECTING HORIZONTAL FORMAT 

.Mnn Sets left margin to nn spaces (number of blank spaces between 
the left edge of the page and the first printed character of 
normal print line). The size of the margin in inches depends 
on the character font selected. 

.Inn Sets the indent to nn spaces beyond the left margin. Text 
following this command will start printing nn spaces to the 
right of the left margin, and will have print lines which are nn 
spaces shorter than the normal line length. This command is 
not used for indenting the first line of a paragraph; it is used 
to indent the whole paragraph. Indenting the first line of a 
paragraph can be done by entering leading spaces or by using 
an imbedded tab as the first character of the paragraph. In 
this case, the first line will start one space after the column 
set by the first tab. The indent I must always be less than the 
line length L. 

.Lnnn Sets the length of the print line to nnn spaces. In fonts 1, 2, 
and 3, there will be nnn characters printed on a standard line. 
In the proportional fonts (usually 4 and 5), there will generally 
be considerably fewer than nnn characters, since most 
characters are wider than spaces, but the physical length will 
stay constant for a given font, regardless of the variation in 
character width. 

.Jn Sets right justification control to n (n=0 turns off justification 
but retains word wrap, n=l produces right justification, n=2 
turns off word wrap, and n=3 produces microspaced 
justification for some printers). 

.Tnn,mm Sets first two tabs at nn and mm spaces from the left-most 
print position. Up to eight tabs can be set, with a maximum 
column of 240. When a tab character is encountered during 
printout, the printer will space to the next tab column before 
printing the character following the tab symbol. 

.Xnn Sets spacing between first and second columns to nn spaces. 

If nn is zero (the default value), only single-column printing 
will be performed. If nn is non-zero, double-column printing 
will be activated (in this case L should be readjusted so both 
columns will fit on the page). 
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.c 


Centers next text line. This must be used as a separate format 
line immediately preceding the text to be centered. The total 
length of the paragraph following the center command must 
not exceed the line length defined by L. The text will be 
centered between the left margin (set by Mnn) and the right 
margin (determined by M+L), without regard to the indent 
setting (I). 

.A Alternate command. VVhen placed above a split-justified line, 
the left and right parts of that line will be reversed on even 
pages. 

OTHER FORMAT COMMANDS 

.D Sets print format parameters to default values. This must be 
used as a separate format line without any numbers. This 
command does not reset the page number (N), the 
view-to-print transition (V), nor the wait option (W). 

•Fn Sets font parameter to n. Five fonts are supported. Although 
these vary from printer to printer, the most common 
assignments are these: 

1= Pica (standard 10 characters/inch) 

2= Elite (12 characters/inch) 

3= Compressed (this varies between 16.7 and 17 CPI, depend¬ 
ing on the printer) 

4= Proportional Characters (at 22.86 spaces per inch) 

5= Proportional Characters (at 20 spaces per inch) 

Reference Section 6 describes the specific font assignments 
for each of the supported printers. If a font is selected for a 
printer which cannot support it, the font setting will be 
ignored during printout. 

.Nnnn Sets page numbers to start with nnn on first page printed. This 
parameter has a default value of 1 and is incremented by one 
after each page is completed. The page number is inserted 
within header or footer blocks wherever a symbol appears. 
The .Nnnn command itself should only be used in the main 
text. If placed within a header or footer block it will be 
ignored. If N is set to zero, it will not be incremented after 
every page. 
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.Vnn Sets the view-to-print transition page. Pages with numbers 
less than nn will be printed to the screen. Pages with numbers 
greater than or equal to nn will be printed on the printer. 

.Wn Sets wait option (l=stop at end of each page, 0=no stop). This 
is useful while printing single sheets in a printer with friction 
drive. When a page is completed, the prompt "PAGE DONE, 
PRESS START TO CONTINUE" will appear. After you have 
positioned the new page in the printer, press START to print 
the next page. The default setting is 0 (no waiting at page 
ends). If W is set to one while double-column printing, then 
the program will wait at the end of each column, even if your 
printer has reverse line-feed capability and thus wouldn't need 
to wait. 

® This character followed by a RETURN constitutes the only 

format line that does not use a leading period. It's function is 
to temporarily stop printout in the middle of a page. This is 
primarily useful for letter quality printers: it allows changing 
fonts by changing daisy wheels. Once printing is paused, you 
are prompted to press any key to resume printing. 


IMBEDDED FORMAT CHARACTERS 

In addition to the font modifier characters described on Page R-15, 

there are five other characters which have special formatting 

functions: 

\ (BACKSLASH) Split justification character. When this character is 
placed within a paragraph shorter than a print line, text to the left 
of the character will be justified against the left margin, while text 
to the right of the character will be justified against the right 
margin. This is especially useful in header and footer blocks. 

^ (TAB CHARACTER) When this is imbedded in the text, the print 
head will be advanced to the next tab column before the text 
following this character is printed. If the print head is already past 
the last tab column a single space will be inserted. 

# (NUMBER SYMBOL) Has special significance only in headers and 
footers, where it will be replaced by the current page number on 
printout. 

! (EXCLAMATION POINT) Comment Character. When this is the 
first character of a paragraph, the paragraph will be interpreted as 
a comment and will not be printed. Comment paragraphs should not 
exceed 250 characters. 
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] (VERTICAL BAR) Soft Hyphen. This character marks possible 
break points where hyphens can be inserted in long words. 
Hyphenation will only occur if the word can be split between two 
print lines. To avoid double hyphens when used with a hard hyphen, 
it should be inserted after a hard hyphen. 

| (INVERSE-VIDEO SPACE) Hard space character. This character is 
printed as a space but will not be treated as a space during word 
wrap or justification functions. It is used to prevent constructs like 
'Figure 5', or '10 acres' from being split between lines. 


FONT MODIFIERS 

Special characters called "FONT MODIFIERS" can be used in pairs to 
start and stop underlining, emphasized print, double-strike print, 
italics, super and subscripts,and double width print. Key-ins needed to 
insert these characters are listed on page R-15. The meaning of some 
of these modifiers vary from printer to printer (see Reference Section 
6 ). 

HEADER AND FOOTER MARKER LINES 

Header and footer text must be imbedded within the text file and 
identified by special marker lines: >. 

:H <RET> Should be placed just before the header text block. 

:F <RET> Should be placed just before the footer text block. 

: <RET> Should be placed just after a header or footer block. 

If beginning and end markers are not used in pairs, a "FORMAT 
ERROR" message will be displayed when you try to print the file. 

A simple header, with appropriate marker lines, can be inserted using 
the EDIT command SHFT-CTRL-H. This produces the header block 

:H«- 

TITLE\Page #«- 


which will print a left-justified TITLE and a right-justified page 
number on the first line, followed by two blank lines before the main 
text block is printed. 
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6.0 GUIDE TO PRINTERS 


This section describes important factors to be aware of in setting up 
your printer, describes the special capabilities of the supported 
printers, and describes how to control unsupported printers. You should 
note that some format parameters have different meanings for 
different printers. 


6.1 GENERAL GUIDELINES 

Many printers have internal switches which provide special operating 
characteristics. These are described in the owner's manual for each 
printer. The most important options to watch for are discussed below. 

LINE FEED AFTER CARRIAGE RETURN 

Some printers allow two options in their response to a carriage return 
code: one which executes a line feed, and one without a line feed. 
Make sure that the line feed option is selected, or all printed text may 
appear on the same line! 

AUTOMATIC PERFORATION SKIPOVER 

This option, available on some MX-80's, is a great convenience for 
making listings of BASIC programs but is not needed by The Writer's 
Tool, since it controls margins independently. If you have an 
unsupported printer which does automatic perforation skip-over, it 
should be turned off (if possible) since it will add extra line feeds at the 
end of a page and thus interfere with the page formatting performed by 
The Writer's Tool. Alternatively, you could set the page length 
parameter to compensate for these extra line feeds. 

If you have an MX-80 with perforation skipover, you should leave this 
function turned on, since The Writer's Tool has built in software to 
control this function as needed. This is a convenience because you 
won't have to change the switch settings when you change from 
word-processing to BASIC programming. 
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PAPER OUT SENSING 


Printers with friction drive can be used with single sheets (using The 
Writer's Tool wait option makes single-sheet printing especially 
convenient). However, some of these printers have a paper-out sensor 
which activates before the end of the page is reached. In this case, 
successful printing of single sheets will require disabling the sensor. In 
some cases this can be done by sending a control code to the printer 
(consult your owner's manual). [You don't need to worry about this if 
you have an MX-80, since The Writer's Tool has built in software 
control of this function.] In other cases, it will be necessary to 
physically disable the sensor by some means (usually wedging a piece of 
cardboard to hold a microswitch closed will do the job). Before you 
attempt any fix, try single-sheet printing and see what happens. 

SELECT AT TURN-ON 

Some printers have a front panel SELECT button. When the printer is 
SELECTed, it is "on-line" and ready to receive data from your 
computer. When the printer is de-SEL£CTed, it is "off-line" and 
cannot receive print data, but will respond to other front panel 
switches (line feed or "LF", and top-of-form or "TOF"). Printers with a 
front panel SELECT switch usually have an internal switch determining 
whether the printer will come up in the SELECT or de-SELECT state 
when the printer is first turned on. You will find it a great 
convenience to set this switch so that your printer will come up 
selected. 

All of the supported printers can also be used in the GENERIC mode, 
although this eliminates support of the special features. [If you use 
your printer in two different modes, turn it off and on to reset it 
between modes.] 
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6.2 ATARI PRINTERS 


In the following tables CPI denotes characters per inch, SPI denotes 
spaces per inch, and LPI denotes lines per inch. 


AVAILABLE FONTS AND LINE SPAC1NGS 



ATARI 825 

ATARI 1025 

ATARI 1027 

FI 

Pica (10CPI) 

Pica (10CPI) 

Elite (12CPI) 

F2 

— 

— 

-- 

F3 

Compressed (16.7CPI) 

Comp. (16.7CPI) 

- 

F4 

Proportional (21.4SPI) 

WIDE (5CPI) 

- 

F5 

Spaced Prop.(18.75SPI) 

— 

— 

SI 

Single SP. (6LPI) 

Single (6LPI) 

Single (6LPI) 

S2 

Double Sp. (3LPI) 

Double (3LPI) 

Double (3LPI) 

S3 

1.5 Spaced (4LPI) 

- 

- 

S4 

1/2 Spaced (12LP1) 

- 

- 


AVAILABLE FONT MODIFICATIONS 


ATARI 825 ATARI 1025 ATARI 1027 


SHFT-CTRL-E 

SHFT-CTRL-D 

SHFT-CTRL-I 

SHFT-CTRL-W 

SHFT-CTRL-U 

SHFT-CTRL- + 

SHFT-CTRL-+ 


Double Wide 
Underline 
Superscript 
Subscript 


Underline 


International Chars. 


Underline 
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PRINTER FILES TO USE WITH ATARI PRINTERS 


Printer Printer Data File Name 


ATARI 825 
ATARI 1025 
ATARI 1027 


AT825.PPP 

AT1025.PPP 

AT1027.PPP 


ADDITIONAL ATARI NOTES 

Micro-spaced justification (.J3) cannot be used. 
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6.3 EPSON AND GEMINI PRINTERS 


AVAILABLE FONTS AND LINE SPACINGS 



MX-80 

MX-80 w/G+ 

GEMINI 10X 
FX-80, RX-80 

FI 

Pica (10CPI) 

Pica (10CPI) 

Pica (10CPI) 

F2 

— 

— 

Elite (12 CPI) 

F3 

Cond. (16.5CPI) 

Cond. (16.5CPI) Cond. (I6.5CPI) 

F4 

- 

— 

Prop. (20SPI) [oi 

F5 

-- 

-- 

— 

SI 

Single Sp. (oLPI) 

Single (6LP1) 

Single (6LPI) 

S2 

Double Sp. (3I.PI) 

Double (3LPI) 

Double (3LPI) 

S3 

1.5 Sp. (4LPI) 

1.5 Sp. (4LPI) 

1.5 Sp. (4LPI) 

S4 

1/2 Sp. (12LPI) 

1/2 Sp. (12LPI) 

1/2 Sp. (12LPI) 


AVAIL-\3LE FONT MODIFICATIONS 



MX-80 

MX-80 w/G+ 

GEMINI 10X 
FX-80, RX-80 

SHFT-CTRL-E 

Emphasized 

Emphasized 

Emphasized 

SHFT-CTRL-D 

— 

Double strike 

Double strike 

SHFT-CTRL-I 

- 

Italics 

Italics 

SHFr-CTRL-W 

Double Wide 

Double Wide 

Double Wide 

SHFT-CTRL-U 

Underline 

Underline 

Underline 

SHFT-CTRL- f 

Superscript 

Superscript 

Superscript 

SHFT-CTRL-+ 

Subscript 

Subscript 

Subscript 


Although the MX-80 with Graftrax-Plus supports all of the font mod¬ 
ifications listed, there are some restrictions on their use. For example, 
compressed and elite fonts cannot be printed with an emphasized 
modifier (although they can be printed with the double-strike 
modification). 
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PRINTER FILES TO USE WITH EPSON OR GEMINI PRINTERS 


Printer 

Printer Data File Name(s) 

EPSON MX-80 

MX80.PPP 

FX-80 

FX80.PPP 


FX80M.PPP* 

MX-80 w/G+ 

MX80G.PPP 


MX80GS.PPP** 

RX-80 

RX80.PPP 

GEMINI 10X 

GEM10X.PPP 


* This data file has two major changes (relative to the FX80.PPP file) 
which may be useful for handling equations and special symbols: (1) 
unlimited levels of superscripts and subscripts are supported at the 
expense of changing the interpretation of imbedded arrows (in this case 
an up arrow starts a superscript, but a down arrow stops it); (2) the 
ROM character set of the FX80 is not copied into the RAM character 
set (thus any special characters which you have down-loaded to the 
printer will not be erased by The Writer's Tool when you select font 4 
(however, this makes you responsible for putting characters into the 
FX80 RAM character set, without which font 4 will print as blank 
characters). 

** Uses half height characters for super and subscripts and prints 
faster than the method used with the other two drivers. 

ADDITIONAL EPSON AND GEMINI NOTES 

Micro-spaced justification (.J3) cannot be used. 

The FX-80 always prints proportional characters with an emphasized 
modification and will not respond to a backspace (CTRL-H) in this font. 
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6.4 PROWRITER AND NEC 8023 PRINTERS 

AVAILABLE FONTS AND LINE SPACINGS 

PROWRITER 8510 or NEC 8023 

FI Pica (10CPI) 

F2 Elite (12CPI) 

F3 Condensed (16.7CPI) 

F4 Proportional (22.86SPI) 

F5 Spaced Proportional (20SP1) 

51 Single Spaced (6LPI) 

52 Double Spaced (3LPI) 

53 1.5 Spaced (4LPI) 

54 1/2 Spaced (12LPI) 

AVAILABLE FONT MODIFICATIONS 

PROWRITER 8510 or NEC 8023 

SHFT-CTRL-E Emphasized (Bold) 

SHFI-CTRL-D — 

SHFT-CTRL-1 — 

SHFT-CTRL-W Double Wide 
SHFT-CTRL-U Underline 
SHFI'-CTRL- + Superscript 
SHFT-CTRL-+ Subscript 

PRINTER FILES TO USE WITH PROWRITER OR NEC PRINTERS 
Printer Printer Data File Name 


PROWRITER PROWRTR.PPP 
NEC 8023 NEC8023.PPP 
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6.5 OKIDATA PRINTERS 


AVAILABLE FONTS AND LINE SPACINGS 



Micro-Line 82A 

Micro-Line 92 

FI 

Pica (10CPI) 

Pica (10CPI) 

F2 

- 

Elite (12 CPI) 

F3 

Condensed (16.5CPI) 

Condensed (16.5CPI)) 

F4 

WIDE (5CPI) 

Corresp. Qual. Pica (10 CPI) 

F5 

— 

Corresp. Qual. Elite (12 CPI) 

SI 

Single Sp. (6LPI) 

Single Sp. (6LPI) 

S2 

Double Sp. (3LPI) 

Double Sp. (3LPI) 

S3 

— 

1.5 Sp. (4LPI) 

S4 

— 

1/2 Spaced (12LPI) 


AVAILABLE FONT MODIFICATIONS 



ML-82A 

ML-92 

SHFT-CTRL-E 

— 

Emphasized 

SHFT-CTRL-D 

— 

Double-strike 

SHFT-CTRL-I 

— 

— 

SHFT-CTRL-W 

— 

Double Wide 

SHFT-CTRL-U 

— 

Underline 

SHFT-CTRL- f 

- 

Superscript 

SHFT-CTRL-+ 

- 

Subscript 


NOTE: The ML-92 does not allow emphasized or double-strike printing 
of correspondence quality fonts (4 and 5). 
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PRINTER DATA FILES TO USE WITH OKIDATA PRINTERS 
Printer Printer Data File Name 


MicroLine 82A ML82A.PPP 
MicroLine 92 ML92.PPP 


MICROSPACED JUSTIFICATION 

The correspondence quality fonts (4 and 5) of the ML-92 can take 
advantage of the microspaced justification option (.J3). See Tutorial 
Section 6.10 for an example. 
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6.6 THE COMREX CR-II PRINTER 


The Writer's Tool supports most functions of the COMREX CR-II 
Daisy-Wheel Printer, including four character pitches, two-color 
printing, proportional and microspaced justification, and automatic 
sheet feeder operation. 

The switching of fonts on daisy-wheel printers may involve changes of 
character pitch and/or a change in print wheels. Changing print wheels 
can be done after a pause command line (©RETURN), or within a line, 
using SHFT-CTRL-W before and after the text to be printed with a 
different wheel. When you change a print wheel, make sure that you 
lift the entire printer cover, not just the clear plastic part; this will 
insure proper wheel alignment when printing resumes. Since lifting the 
cover will always leave the printer deSELECTED, you will have to 
press the printer's SELECT button after closing the cover. 

AVAILABLE PITCHES AND LINE SPACINCS 

COMRITER CR-n 

FI Pica (10CPI) 

F2 Elite (12CPI) 

F3 Condensed (15CPI) 

F4 Proportional (20SPI) 

F5 - 

S! Single Spaced (6LPI) 

52 Double Spaced (3LP1) 

53 1.5 Spaced (4LPI) 

54 1/2 Spaced (12LPI) 


NOTE: Do not use a zero margin with the proportional font. It is not 
possible to align proportional characters against a zero left margin. If 
you try it, the first character of each line will be dropped. 
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AVAILABLE FON T MODIFICATIONS 


COMRITER CR-II 


SHFT-CTRL-E 

SHET-CTRL-D 

SHEr-CTRL-I 

SHFT-CTRL-W 

SHFT-CTRL-U 

SHFT-CTRL-t 

SHFT-CTRL-+ 


Emphasized (Shadow Print) 

Double Strike (without moving print head) 
Red Print 

Pause for wheel change 
Underline 
Superscript 
Subscript 


The modifiers supported by the CR-II printer can be used with any font 
and in any combination. 

As with all font modifiers, the wheel change pause is an on/off toggle 
and should be used in pairs. If you insert only one wheel change pause, 
a pause will occur at the beginning of every succeeding print line. 

Each wheel change pause character will cause a DESELECT code to be 
sent to the printer. Using a format line pause (©RETURN) will not 
deselect the printer. In either case, after changing the wheel you will 
need to press the printer SELECT button to resume printing. 

There is one problem with wheel changes within a line: you may only 
have about 30 seconds to do the change. This happens because the 
ATARI operating system will not wait indefinitely for the printer to 
come back to the SELECTED state. This problem can be avoided by 
inserting a format line pause (©RETURN) at the end of the paragraph 
within which the change is to be made (provided that the paragraph is 
shorter than 500 words). If you intend to print an entire paragraph with 
a different wheel, it is most convenient to use the ©RETURN pause 
just before and after the paragraph; this method will give you all the 
time you want for wheel changes. 

PRINTER FILES TO USE WITH THE CR-II PRINTER 

Printer Printer Data File Name 


COMREX CR-II CRI1.PPP 
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CUT SHEET FEEDER OPERATION 


To obtain automatic sheet feeding, you must use the default page 
length of 66 single spaced lines per page. Also remember to keep the 
acoustic cover in place; otherwise finished pages won't be pulled into 
the tray. 

PAPER ALIGNMENT 

The print head starting position is software-controlled to match the 
paper alignment forced by the cut sheet feeder. If you aren't using a 
sheet feeder, you should insert paper so that the left edge of the paper 
is 1/2 inch to the right of the zero mark on the paper bar (the left edge 
should line up with the 5th tic mark and the right edge should line up 
with the 90th tic mark). This alignment should also be used with a 
tractor drive. 
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6.7 USING NEARLY EQUIVALENT PRINTERS 

Some printers absent from the above tables need not be used in the 
GENERIC mode: 

CENTRONICS 737 This printer is supposed to be functionally 
equivalent to the ATARI 825 printer and should therefore be used in 
the AT825 mode. 

OTHER EPSON COMPATIBLE PRINTERS The Mannesman Tally 
Spirit 80 is one of several printers which claim to be compatible 
with EPSON printer control codes. These printers should work with 
one of the MX data files installed. 


6.8 CONTROLLING UNSUPPORTED PRINT FUNCTIONS 

There are alternative, but less convenient, ways to control printer 
functions. You can insert control codes in the text directly, then 
surround the codes with SHFT-CTRL-P symbols {so they are not 
counted as spaces by the formatting routines). Use this method if your 
printer is not one of the primary ones but still has special capabilities 
of which you want to take advantage. 

The general procedure for using imbedded control codes is as follows: 
(1) select a function you wish to activate, (2) look up the control code 
sequence for that function in your printer manual, (3) look up, in 
Appendix 1, the characters corresponding to these code numbers and 
the keystrokes necessary to generate them, (4) insert the appropriate 
characters in the text, and (5) surround the imbedded sequence with 
protector characters (entered with SHFT-CTRL-P). 

PRINTER GRAPHICS 

Printer graphics can be inserted into printed text without greatly 
disturbing print formatting, provided proper use is made of the 
SHFT-CTRL-P symbol, and the CTRL-[,] symbol (displayed as a heart). 
How they should be used is best explained by following the example 
presented in Tutorial Section 11. 
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7.0 GUIDE TO ERROR MESSAGES 


This section on errors is arranged for trouble shooting. The error 
messages and warnings are grouped according to which function was 
active when the error occurred. 


7.1 ERROR MESSAGES DURING EDITING 

"CURSOR PAST END OF TEXT" (accompanied by a buzzer). This 
message is displayed when you try to activate commands which 
do not operate when the cursor is past the end of the entered 
text. These commands are page forward, insert a block marker, 
copy a block, and convert between upper and lower case. 

"CURSOR ERROR" (accompanied by a buzzer) This error signal is 
produced during block copy if the cursor is between the block 
markers. (A block cannot be copied to a location within itself.) 
It is also produced if you try to type past the end of the text 
memory buffer. 

"MARKER ERROR" (accompanied by a buzzer) This error can occur 
during block copy or block delete operations if there are less 
than two block markers imbedded in the text. 

"OUT OF MEMORY" (accompanied by a buzzer) This message can 
result when an attempt is made to insert an amount of text 
which exceeds the available memory space. This might happen 
during block copy, during text entry in the INSERT mode, or in 
the execution of SHIFT-INSERT or CTRL-INSERT. When this 
happens it is time to consider splitting the text file into two 
smaller files. The simplest procedure is to move the cursor to a 
natural breakpoint (say the start of a major section), then save 
all text after that point using a new filename. Once this is done 
the text just saved can be CLEARED from the text buffer and 
the remaining text saved under the old file name. 
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7.2 ERROR MESSAGES DURING PRINTOUT 


"BAD FORMAT LINE" (accompanied by a buzzer) If a bad imbedded 
format line is encountered during printout, a buzzer is sounded, 
control returns to the EDIT mode, the error message is displayed 
on the status line, and the cursor is left flashing at the beginning 
of the bad format line positioned at the top of the screen. This 
usually means that the format line contains a typographical 
error. 

"DEVICE NOT RESPONDING" (accompanied by a buzzer) This usually 
means that either the 850 Interface Module or the printer is not 
turned on, or that the printer is not on line (or not 'selected'). 

"Cannot find—Dn:LINKNAME" (accompanied by a buzzer and a disk 
error message) This message can only occur during linked 
printing, if the named linkfile cannot by found on the designated 
disk. If you insert a disk which does have the designated file, 
you can continue the linked print by pressing START. Otherwise 
you can abort the printout by pressing OPTION. 

"WARNING:Current text buffer contents will be erased during linked 
printing" (accompanied by a high-pitched beep) Since linked 
printing does not preserve the initial contents of the text buffer, 
this message is provided as a reminder to save the text on disk if 
you want to preserve it. The prompt "OK to continue (Y/N)?" 
should be answered in the negative if you want to return to the 
EDIT mode and save the text before proceeding with the linked 
printing operation. 


R-53 



7.3 ERROR MESSAGES DURING DISK OPERATIONS 


"BAD FILE NAME" The file name may have lower case letters or other 
illegal characters. It should start with upper case letters and 
have only upper case letters and numbers (except for the period 
separating primary and secondary names). 

"DATA FRAME ERROR" The diskette may be faulty. 

"DEVICE MALFUNCTION" The disk drive may be in need of repair. 

"DEVICE NOT RESPONDING" The disk drive may have been turned off 
or disconnected. 

"DIRECTORY FULL" You can have a maximum of 64 different files on 
a disk. 

"DISK ERROR" The disk may have a write protect tab, or the disk 
directory may be scrambled. 

"DISK FULL" There is no room on the disk to save the file. 

"FILE LOCKED" You cannot write over or erase a locked disk file. 

"FILE NOT FOUND" This means that the disk drive specified does not 
have the file specified. You may have used the wrong drive 
number or forgotten to insert the right disk. 

"WARNING: Entire file not loaded" (accompanied by a buzzer). This 
will appear if the memory space between the cursor and the end 
of the memory buffer is not large enough to hold the file you 
attempted to load. 

"WARNING: Load will overwrite current text (from cursor thru 
txtend)" (accompanied by a high-pitched beep). This will appear 
if you attempt a LOAD operation which might destroy part of 
the text currently in the text buffer. If you want to add the 
loaded file to the current text, move the cursor one character 
past the end of the current text before proceeding. Otherwise, 
just ignore the warning. 

"WARNING: Only part of text buffer will be saved (cursor thru txtend)" 

(accompanied by a high-pitched beep). This may occur during a 
SAVE operation if the cursor is not at the beginning of the text 
buffer. This may not be an error if you really intend to save just 
part of the file. 
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7.4 ERRORS IN RESPONDING TO PROMPTS 


When prompts are presented in the command window, certain 
conventions are expected. If you don't follow them, a buzzer will 
sound and the prompt may be redisplayed without a specific error 
message telling you what you did wrong. In such cases it is best to 
consult the Reference Guide for a description of the function which 
you were attempting to activate at the time the error signal was 
produced. Most often this means that you answered a prompt with an 
inappropriate response. 


8.0 CUSTOMIZING PROCEDURES 

This section summarizes the procedure for customizing the operation 
of The Writer's Tool. 

PRINTER CUSTOMIZATION 

Information needed to control special printer capabilities is contained 
in each of the ".PPP" files provided on The Writer's Tool disk. Any one 
of these files can be manually installed using the CHNGE function 
available from the Print System. 

FORMAT AND DISPLAY CUSTOMIZATION 

Changing the default settings of the format parameters and the 
characteristics of the screen display can be accomplished by creating 
and installing a custom format file (designated by the ".FFF" extender). 

A custom format file can only be created using the CUS'fOM.BAS 
program. This BASIC program can be accessed by holding down the 
SELECT switch while The Writer's Tool is boot loading. If you are not 
using an 800XL, you will also need a BASIC cartridge to run this 
program. 


A custom format file can be manually installed using the 
CHNGE function available through the Print System. 

AUTOMATIC INSTALLATION DURING BOOT LOAD 

The Writer's Tool can be made to load automatically the printer and 
format information at start-up. This requires that (1) a copy of the 
desired printer file and a copy of the desired format file must be 
present on The Writer's Tool disk, and (2) the extender name of the 
copy must be ".PDF" for the printer file and ".FDF" for the format file. 


R-55 



For example, to create a customized version of the program which 
automatically loads the MX-80 printer information, and also loads 
format information stored in a file named "FORM.FFF", you should 
perform the following steps: 

Create the file FORM.FFF 

(1) Install a BASIC cartridge (unless you are using an 800XL). 

(2) With The Writer's Tool disk in drive 1, hold down the 
SELECT switch and turn on your computer. Leave the 
SELECT switch depressed until the CUSTOMIZER program begins. 

(3) Use the Customizer program to modify format defaults and display 
characteristics, then save the changes in a file named "FORM.FFF" 
(the FFF extender will be automatically added by the Customizer 
program). 

Install printer and format files on The Writer's Tool disk 

(4) Remove the write protect tab from The Writer's Tool disk, then 
boot load the program in the normal fashion (remove the BASIC 
cartridge and do not press SELECT). 

(5) Use the Disk I/O System to load the file "MX80.PPP" into memory 

(be careful not to modify this file in any way). 

(6) Save the file on The Writer's Tool disk using a different filename: 
"MX80.PDF" (this completes the printer installation). 

(7) Next load the file "FORM.FFF" from whatever disk it was saved to 

(be careful not modify this file in any way). 

(8) Re-insert The Writer's Tool disk and then save the memory contents 
using the name "FORM.FDF" (this completes the format file 
installation). 

(9) Replace the write-protect tab on The Writer's Tool disk. 

From now on, both "MX80.PDF" and "FORM.FDF" will be 
automatically loaded as part of The Writer's Tool boot process. 
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The Writer's Tool Version 2.0 


Copyright 1984 Madison Micro 


APPENDIX 1. CHARACTER CODES AND KEY-STROKES 

There are 256 possible characters which are recognized by your ATARI 
computer. These are numbered from 0 to 255 (decimal) or 0 to FF 
(hexadecimal). 

The following three pages contain tabulated decimal and hex values of 
the character codes, the appearance of the characters, and the 
key-strokes needed to produce them. 

USING THE TABLE 

To insert printer control codes for an unsupported printer or graphics 
controls for any printer, you will need to translate decimal or hex 
codes listed in your printer manual into key-strokes. For example, to 
start double-width print mode on an Integral Data Systems 560 printer, 
you must send the printer a decimal 1 (same as hex 1). In the following 
table you will find that the character corresponding to this code is 
produced by entering ESC CTRL-A. By inserting this character in the 
text and surrounding it with SHFT-CTRL-P characters, the appropriate 
code will be sent to the printer when the text is printed. 

Producing Greek characters with a PROWRITER is another task which 
the table can support. For example, consulting the PROWRITER 
manual shows that the greek character OMEGA (Q) can be printed by 
sending the hex code BC (188 decimal). This corresponds to the ATARI 
inverse video '«' character. Wherever this character appears in the 
file, the fl character will appear in the printout. In this case, since the 
character does use a known space on the paper, you do not need to 
surround it with protector characters. 

RESERVED CODES 

The Writer's Tool uses some characters for formatting functions (such 
as inverse exclamation point, backslash, and a few others). To send the 
corresponding character codes to a printer requires surrounding them 
with SHFT-CTRL-P protector codes. There are only two codes which 
cannot be sent to a printer: a decimal 155 (translated to 13 by the 
interface module), and decimal 137 (the SHFT-CTRL-P character 
code). 
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DEC HEX CHAR KEYSTROKES 


DEC HEX CHAR KEYSTROKES 


e 

8 

♦ 

ESC CTRL-, 

i 

1 

h 

ESC CTRL-A 

2 

2 

l 

ESC CTRL-B 

3 

3 

j 

ESC CTRL-C 

4 

4 

i 

CTRL-D 

5 

5 


ESC CTRL-E 

6 

7 

8 

6 

7 

8 

< 

A 

ESC CTRL-F 
CTRL-6 
CTRL-H 

9 

9 

1 

ESC CTRL-I 

IB 

11 

12 

A 

B 

C 

■ 

ESC CTRL-J 
CTRL-K 
CTRL-L 

13 

D 


ESC CTRL-H 

14 

E 


CTRL-H 

15 

F 

■ 

ESC CTRL-0 

16 

10 

♦ 

CTRL-P 

17 

11 

r 

CTRL-Q 

18 

12 


ESC CTRL-R 

19 

13 

+ 

ESC CTRL-S 

28 

14 

• 

ESC CTRL-T 

21 

15 

m 

ESC CTRL-U 

22 

16 

1 

CTRL-W 

23 

17 

T 

ESC CTRL-H 

24 

18 

J. 

ESC CTRL-X 

25 

19 

1 

CTRL-Y 

26 

1A 

k 

ESC CTRL-Z 

27 

IB 

l 

ESC ESC 

28 

1C 

♦ 

ESC CTRL-* 

29 

ID 

4 

ESC CTRL-4 

30 

IE 

* 

ESC CTRL-* 

31 

IF 

4 

ESC CTRL-* 

32 

20 

space 

SPACE BAR 

33 

21 

! 

SHIFT-1 

34 

22 

ii 

SHIFT-2 

35 

23 

n 

SHIFT-3 

36 

24 

$ 

SHIFT-4 

37 

25 

X 

SHIFT-5 

38 

26 

& 

SHIFT-6 

39 

27 

• 

SHIFT-7 

48 

28 

c 

SHIFT-9 

41 

29 

3 

SHIFT-0 

42 

2A 

* 

* 

43 

2B 

4 

■i 

44 

2C 

a 

a 

45 

2D 



46 

2E 

, 

, 

47 

2F 

/ 

/ 

48 

30 

0 

0 

49 

31 

1 

1 

50 

32 

2 

2 

51 

33 

3 

3 

52 

34 

4 

4 

53 

35 

5 

5 

54 

36 

6 

6 

55 

37 

7 

7 

56 

38 

8 

8 

57 

39 

9 

9 

58 

3A 

i 

shift-: 

59 

3B 

J 

a 

60 

3C 

< 

< 

61 

3D 

z 

- 

62 

3E 

> 

> 

63 

3F 

* 

SHIFT-? 


64 

40 

65 

41 

66 

42 

67 

43 

68 

44 

69 

45 

78 

46 

71 

47 

72 

48 

73 

49 

74 

4A 

75 

4B 

76 

4C 

77 

4D 

78 

4E 

79 

4F 

80 

SB 

81 

51 

82 

52 

83 

53 

84 

54 

85 

55 

86 

56 

87 

57 

88 

58 

89 

59 

90 

5 A 

91 

5B 

92 

5C 

93 

5D 

94 

5E 

95 

5F 

96 

60 

97 

61 

98 

62 

99 

63 

100 

64 

101 

65 

102 

66 

103 

67 

184 

68 

105 

69 

106 

6A 

107 

66 

108 

6C 

109 

6D 

118 

6E 

111 

6F 

112 

70 

113 

71 

114 

72 

115 

73 

116 

74 

117 

75 

118 

76 

119 

77 

120 

78 

121 

79 

122 

7A 

123 

7B 

124 

7C 

125 

7D 

126 

7E 

127 

7F 


G SHIFT-8 

A A 

B B 

C C 

D D 

E E 

F F 

G G 

H H 

I I 

J J 

K K 

L L 

H M 

N N 

0 0 

P P 

Q Q 

R R 

S S 

T T 

u u 

0 u 

M M 

X X 

Y Y 

z z 

t SHIFT-I 

\ 5HIFT-\ 

3 SHIFT-3 

A SHIFT-a 

- SHIFT-- 

♦ CTRL-, 

a a 

b b 

c c 

d d 

e e 

f f 

9 9 

h h 

i a 

j J 

k k 

1 1 

n m 

n n 

o o 

P P 

q q 

r r 

s s 

t t 

u u 

V V 

tf V 

X X 

y y 

z z 

♦ CTRL-j 

| SHIFT-1 

♦ ESC SHIFT-CLEAR 

i ESC BACK S 

► ESC TAB 
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DEC HEX CHAR KEYSTROKES DEC HEX CHAR KEYSTROKES 


128 

88 

u INU 

CTRL-» 

192 

C0 

c 

INU 

SHIFT-e 

129 

81 

: inu 

ESC 

CTRL-A 

193 

Cl 

Q INV 

A 

138 

82 

1 INU 

ESC 

CTRL-B 

194 

C2 

[ 

INV 

B 

131 

83 

J INU 

ESC 

CTRL-C 

195 

C3 

0 INU 

C 

132 

84 

1 INU 


CTRL-D 

196 

C 4 

0 INU 

D 

133 

85 H INU 

ESC 

CTRL-E 

197 

C5 

S INU 

E 

134 

86 

INU 

ESC 

CTRL-F 

198 

C6 


i INU 

F 

135 

8? 

& INU 


CTRL-G 

199 

C7 

( 

3 INU 

G 

136 

88 

r inu 


CTRL-H 

260 

C8 


] INU 

H 

137 

85 

r inu 

ESC 

CTRL-I 

201 

C9 


1 INU 

I 

138 

8A 

’l INU 

ESC 

CTRL-J 

202 

CA 


g inu 

J 

139 

8B 

b INU 


CTRL-K 

203 

CB 

[ 

3 INU 

K 

148 

SC 

INU 


CTRL-L 

204 

CC 

B INU 

L 

141 

8D 

■ INU 

ESC 

CTRL-M 

285 

CD 


[ INU 

N 

142 

8E 

■ INU 


CTRL-N 

206 

CE 


3 INU 

N 

143 

8F 

1 INU 

ESC 

CTRL-0 

207 

CF 

0 INU 

0 

144 

30 

S INU 


CTRL-P 

208 

D0 

1 

2 inv 

P 

145 

51 

r. inu 


CTRL-Q 

209 

D1 

r 

j INV 

Q 

146 

92 “ INU 

ESC 

CTRL-R 

210 

D2 

a inu 

R 

147 

93 ” my 

ESC 

CTRL-S 

211 

D3 

0 INU 

S 

148 

94 

3 INU 

ESC 

CTRL-T 

212 

D4 

a inu 

T 

149 

95 

■ INU 

ESC 

CTRL-U 

213 

D5 

IB INU 

U 

159 

96 

I INU 


CTRL-y 

214 

D6 


g inu 

y 

151 

37 S INU 

ESC 

CTRL-M 

215 

D7 


[ INU 

M 

152 

38 " INU 

ESC 

CTRL-X 

216 

D8 

Q INV 

X 

153 

99 

1 INU 


CTRL-Y 

217 

D9 


a inv 

Y 

154 

9ft 

i my 

ESC 

CTRL-Z 

218 

DA 


3 INV 

z 

155 

SB EOL CO RETURN 


219 

DB 


3 INV 

SHIFT-C 

156 

9C 

3 ESC 

SHIFT-DELETE 

220 

DC 


S INV 

SHIFT-A 

157 

98 

3 ESC 

SHIFT-INSERT 

221 

DD 


I INV 

SHIFT-3 

158 

9E j 

3 ESC 

CTRL 

-TAB 

222 

DE 


b INV 

SHIFT-A 

159 

9F i 

J ESC 

SHIFT-TAB 

223 

OF 


! INV 

SHIFT-- 

168 

A0 i 

1 INU 

SPACE BAR 

224 

E0 


3 INV 

CTRL-. 

161 

ftl 1 

3 INU 

SHIFT-1 

225 

El 


3 INV 

a 

162 

A2 I 

3 INU 

SHIFT-2 

226 

E2 


3 INV 

b 

163 

A3 2 INU 

SHIFT-3 

227 

E3 

a INV 

G 

164 

ft4 

i INV 

SHIFT-4 

228 

E4 


D INV 

d 

165 

A5 | 

2 my 

SHIFT-5 

229 

E5 

a inv 

e 

166 

ft 6 | 

^ iNy 

5HIFT-6 

230 

E6 


a INV 

f 

167 

ft 7 

I iNy 

SHIFT-7 

231 

E7 


1 INV 

9 

168 

A8 

] INy 

5HIFT-9 

232 

E8 

0 INV 

h 

169 

A9 

J iNy 

SHIFT-0 

233 

E9 

0 INV 

i 

170 

Aft 

2 INy 

ESC 

* 

234 

EA 


n inu 

j 

171 

AB | 

2 iNy 

ESC 

■f 

235 

EB 


3 INU 

k 

172 

AC j 

INy 



236 

EC 


1 INU 

1 

173 

AO 

INU 

ESC 

- 

237 

ED 


; inu 

M 

174 

AE 

INV 



238 

EE 


INU 

n 

175 

AF 

INy 

/ 


239 

EF 


3 INU 

0 

176 

B0 

iNy 

8 


240 

F0 


2 INU 

P 

177 

B1 

TNV 

1 


241 

FI 


1 INU 

9 

178 

B2 

3 INy 

2 


242 

F2 


INU 

r 

179 

B3 

3 my 

3 


243 

F3 


5 INU 

s 

180 

B4 

3 iNy 

4 


244 

F4 


3 INU 

t 

181 

B5 

3 iNy 

5 


245 

F5 


) INU 

u 

182 

B6 

! INV 

6 


246 

F6 


Q INU 

y 

183 

B7 

2 iNy 

7 


247 

F7 


I INU 

w 

184 

B8 

] INV 

8 


248 

F8 


3 INU 

X 

185 

B9 

3 iNy 

9 


249 

F 9 


g inu 

y 

186 

BA 

iNy 

SHIFT-! 

258 

FA 


3 INU 

2 

187 

BB 

iNy 

t 


251 

FB 


] INU 

CTRL-; 

188 

BC 

iNy 

< 


252 

FC 


I INU 

SHIFT-| 

189 

BD 

INV 

ESC 

r 

253 

FD 


3 ESC 

CTRL-2 

190 

BE 

iNy 

> 


254 

FE 


J INU 

ESC CTRL-DELETE 

191 

BF 

INV 

SHIFT-? 

255 

FF 


1 INU 

ESC CTRL-INSERT 
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APPENDIX 2. COMMON PROBLEMS 


UNEXPECTED BLANK SPACE ON PRINTOUT 

You inserted a screen line of blank space, typed a few words, then 
forgot to use CTRL-J to close the gap, or forgot to press RETURN. 

UNEXPECTED LINE FEEDS 

If you use a left margin and line length which, in total, equal or 
exceed the number of printer columns, the printer will probably 
execute an automatic line feed in addition to the line feed provided 
by The Writer's Tool (readjust M or L to avoid this). 

BASIC PROGRAM LISTING IS GARBAGE 

A BASIC program that is written to disk using the BASIC SAVE 
command has a tokenized form from which The Writer's Tool 
cannot produce a readable listing. You first need to LIST the 
program to disk from BASIC. This produces a text file which The 
Writer's Tool can then format and print (or edit). 

PROGRAM APPEARS TO BE LOCKED-UP 

It's probably waiting for a response. Most prompts require a 
RETURN at the end of your answer. You may have used the screen 
stop (CTRL-1) and didn't restart it (with a second CTRL-1). With 
some printer interfaces, a long pause can result when you try 
printing with the printer turned off. If all else fails, you can always 
press SYSTEM RESET (this won't damage your current text in 
memory). 

UNEXPECTED PRINT FORMAT 

Check Reference Section 6 to make sure that you haven't tried to 
use a format your printer can't print. 

STRANGE CHARACTERS DISPLAYED NEAR END OF TEXT 

This can happen when you are working on a text file that comes 
close to filling the entire text buffer. In this case, when you move 
the cursor near the end of the text buffer, the display will show not 
only the end of the text, but also the memory contents just past the 
end of the text buffer. This is not a problem, just a reminder that 
you are running out of room. Don't worry about damaging the 
program by typing characters into the non-text area; The Writer's 
Tool won't let it happen. 



APPENDIX 3. USING DIFFERENT DISK DENSITIES 


The number of disk drives available for use with ATARI home 
computers has grown enormously in just the past year. Many of these 
drives are capable of operation at two or three different densities, and 
offer much greater storage capacity than the old Atari 810. 

COMMON DISK DENSITIES 

There are basically three distinct disk formats in common use by 
Atari-compatible disk drives: 

1. Single Density (Atari DOS 2.0s format) which uses 128-byte sectors, 
18 sectors per track, and 40 tracks, for a total unformatted 
capacity of 92,160 bytes. 

2. Medium Density (Atari DOS 3 format) which uses 128-byte sectors, 
26 sectors per track, and 40 tracks, for a total unformatted 
capacity of 133,120 bytes (although this is a bit less than 1.5 times 
the single-density capacity, the Atari DOS 3 manual refers to this 
as "double density"). 

3. Double Density (generally observed industry standard format) which 
uses 256-byte sectors, 18 sectors per track and 40 tracks (for a 
total unformatted capacity of 184,320 bytes, exactly twice the 
single-density capacity). 

USING SINGLE AND DOUBLE DENSITIES 

Although The Writer's Tool is provided in single density disk format, it 
is supplied with a disk operating system capable of writing and reading 
either single or full double-density disks. This disk operating system 
(DOS) is called DOS XL, product of OSS, Inc. (it's stored in the disk file 
DOS.SYS). When The Writer's Tool boots from its master disk, this will 
leave the disk drive set in single density format. To change the disk 
density, use the initialization command available from the Disk I/O 
system (provided, of course, that you are using a disk drive which 
supports dual densities). You can then read, write, and initialize disks 
in double-density format. If you have two disk drives, you have the 
flexibility to operate them in any combination of single and double 
density. You can read a single density disk, then write a double density 
disk, or vice versa. 

USING DOS3 (MEDIUM DENSITY) 

The Writer's Tool can be used to read and write medium density 
formats only if you copy the disk part of the program to a DOS 
3-formatted disk on which you have installed the DOS-3 version of the 
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DOS.SYS file (called FMS.SYS). The copying procedure is described in 
the DOS 3 users guide. This DOS-3 version of the program will only be 
able to read and write DOS-3 formatted disks, and will not be able to 
properly switch between medium and single density formats. 

MAKING A DOUBLE-DENSITY COPY OF THE PROGRAM 

To make a working double-density copy of The Writer's Tool, you must 
copy the disk-based portion of the software to a double-density 
formatted disk which contains your double-density disk operating 
system (usually a DOS.SYS file). Your disk operating system manual 
should describe how to make a double density copy of a single density 
disk. You can also do this just by using The Writer's Tool to load each 
file from the single density master, then save it to a double density 
disk. The only files you really need to copy are DOS.SYS, 
AUTORUN.SYS, MERGE.OBJ, and whichever printer data files you 
may need. For most purposes, there is no need to make a 
double-density copy of the program, since you can reconfigure most 
dual density drives from within the program itself. 

COPYRIGHT REMINDER 

The disk-based portion of The Writer's Tool program is copyrighted 
material, as is the ROM portion. You are authorized to make copies 
for backup and extended use capabilities described above, but you are 
not authorized to sell or distribute such copies. 
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INDEX 


A 


Alternate left/righc (.A) 

R-36, T-49 

ATRACT function 

R-12 

B 

Beginning Line of Footer(.Bnn) 

R-34 

Block Commands 

R-IO, T-10 to 12 

Boot load procedure 

R-3, T-2 

BREAK key 

R-13 


C 


Caps-Lock (SHFT-CAPS) 

R-5, T-14 

Case conversion (CTRL-K.L) 

R-ll, T-13 

Center command (.C) 

R-36, T-38 

CHANGE (CHNGE) command 

R-28 

Character Codes and Keystrokes 

A-1,2,3 

Characters, special, format use 

R-14,15 

Characters, wild-card 

R-19 

CLEAR System 

R-29, T-34 

Color and luminance customizing 

T-84 

Command Window 

R-17, T-17 

Comment lines (!) 

R-37 

Compressed font (.F3) 

R-36.T-67 

Conditional page eject (.Gn) 

R-35, T-52,53 

Console Switches, EDIT use of 

R-16 

Continue search, from EDIT (CTRL-S) 

R-19, T-19 

Control codes, printer 

T-87 

Control Key 

R-13, T-4 

Copy Block (CTRL-C) 

R-10, T-11,12 

Cursor appearance, changing 

R-12, T-16 

Cursor-Exchange (CTRL-CAPS) 

R-5, T-15 

Cursor movement commands 

R-6,7, T-4 

CURSOR (position pointer) 

T-23 

Custom format file 

T-85 

Customizer program 

R-55,56, T-83 to 86 

Customizing procedures 

R-55,56 


D 

Data base, preparing for merge 
Default format setting (.D) 


X-l 


T-76,77 
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Delete block (CTRL-X) 

R-8, T-12 

Delete Diskfile 

R-22, T-28 

Delete text commands 

R-8, T-5 

Directory command 

R-20 

Disk commands 

T-23 

Disk density setting 

A-5,6, R-22, T-26 

Disk Directory, displaying (1 or 2) 

R-20, T-24 

Disk Directory, printing (OPTION + 1 

l or 2) R-20, T-25 

Disk Errors 

R-54 

Disk Files, rules for naming 

R-23, T-25 

Disk I/O System 

R-20 thru 22, T-22,23 

Disk operating systems 

A-5,6 

Disk System warnings 

R-54 

Display commands 

R-12, T-15,16 

Double-column margin (.Xnn) 

R-36, T-59 

Double-column page format 

R-33 

Double-column printing 

T-59 thru 62 

Double density disk drives 

A-5,6, R-22, T-26 

Double-strike print 

R-15, T-68 

Double width characters 

R-15, T-68 


E 


EDIT errors 

R-52 

EDIT System 

R-4 to R-16, T-4 to 16 

Eject (.E) 

R-35, T-51 

Elite Font (.F2) 

R-36, T-67 

Emphasized print 

R-15, T-68 

Equations 

T-55 

Error messages 

R-52 to 55 

ESC key function 

R-13, T-39 


F 


Features summary 

1-3 to 6 

Font modifier insertion 

R-41,51, T-69 

Font modifier examples 

T-68 

Font setting command (.Fn) 

R-36, T-66 

Fonts, definition and examples 

T-65,66,67 

Footer beginning line (.Bnn) 

R-34, T-42 

Footer-block marker lines 

R-38, T-45 

Footer, imbedding in text 

T-45,46 

Footer on last page 

T-46 

Format characters, imbedded 

R-37,38 

Format commands (for printout) 

R-34 to 38 

Format line 

R-34, T-32 

Format line, imbedded 

FORMAT (Print System command) 

R-34, T-35 to 37 

R-24, T-32,33 
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Format priority 
G 


T-37 


Generic print mode 
Greek characters, using 
Group print lines (.Gnn) 

H 

Hard spaces 
Hardware requirements 
Header and footer summary 
Header-block marker lines 
Header, deferring to second page 
Header insert command (SHFT-CTRL-H) 
i leader, insertion in text 
Hyphens, soft 

I 


R-25 

A-l 

R-35, T-52,53 


R-15 
1-1 
T-48 
R-38, T-44 
T-47 
R-9,38, T-44 
T-43,44 
R-38, T-54 


Imbedded format control characters 
Indent (.Inn) 

Indent (with tabs) 

Initializing a disk 
Initializing drive density 
Insert and Join method 
Insert commands 

Insert mode of text entry (CTRL-I) 

Inverse Key 

Italics 

J 

Join command (CTRL-J) 

Justify (.Jn) 

K 


R-14,15 
R-35 
R-35, T-39 
R-22.T-26 
A-5,8, R-22, T-26 
R-9, T-7,8 
R-9 
R-4, T-9 
R-5, T-14 
R-15.T-68 


R-8, T-8 
R-35, T-33, 56 


Keyboard control R-5, T-14, 15 

Keys with special functions R-13 

L 

Left Margin (.Mnn) R-35 

Line feed after carriage return R-39 

Line length (.Lnn) R-35 

Line spacing (.Sn) R-34, T-55 
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Linknames (<Dn:Fname) 

Linkprint functions 
Linkprint explanation 
Loading text from a Disk file 
Lower case lock 

M 

Main Menu 
Margin, left (.Mnn) 

Mark block (CTRL-M) 

MEMEND (pointer) 

Merge System 

Microspaced Justification (.J3) 

N 

Naming rules for disk files 
Null character (CTRL-,) 

Numbering pages 

O 

OPTION key 
Outdent (with tabs) 

P 

Page Eject (.E) 

Page format 
Page length (.Pnn) 

Page number insertion (#) 

Page numbering 

Page starting number (.Nnn) 

Paging, with cursor (CTRL-F, CTRL-R) 
Paper out sensor 
Perforation skipover 
Pica (.FI) 

Pointers 

PRINT command 
Print format guide 

Print pause, at start of line (® <RET>) 
Print pause, within line 
Print preview (.Vnn) 

Print System 
Printer capabilities 
Printer control code protection 
Printer control code transmission 

X-4 


R-26, T-70 
R-26, T-70,71,72 
T-71,72 
R-20,21, T-28,29,31 
R-5, T-4 


R-17, T-17 
R-35 
R-10, T-10,11 
T-23 

R-27, T-74 to 82 
R-35, T-56 


R-23, T-25 
R-14, T-87,88,89 
R-36,37, T-49,50 


R-16,17, T-17 
T-39 


R-35, T-51 
R-30 to 33, T-42 
R-34, T-12 
R-37, T-49 
R-36,37, T-49,50 
R-36, T-50 
R-6,7, T-13 
R-39,40 
R-39 
R-36, T-5 
T-23 
R-25, T-31 
R-30 to 38 
R-37 
R-49 

R-28,29, T-57.58 
R-24 to 29, T-29,30 
R-41 to 51, T-65 
R-51, T-87 
R-51, T-87 thru 89 



Printer data file, installing 

R-55,56, T-64 

Printer graphics 

R-51, T-87 thru 89 

Printer Guide 

R-39 thru 51 

Printer setup 

R-39,40 

Printers, ATARI 

R-41,42 

Printers, COMREX CR-II 

R-48,49,50 

Printers, direct control of 

T-87 

Printers, EPSON 

R-43,44 

Printers, NEC & PROWRITER 

R-45 

Printers, OKIOATA 

R-46,47 

Printers, supported 

R-41 thru 51, T-63 

Printing from middle of document 

R-28, T-58 

Printing in default format 

T-31 

Printing merged documents 

T-78 thru 80 

Printout Errors 

R-53 

Problems, common 

A-4 

Proportional fonts 

R-41,43,45,48, T-66,67 


R 


Reference Guide 

R-l thru R-56 

Reserved character codes 

A-l 

RETURN key function 

R-l3, T-3 


S 


SAVE command 

R-21,22, T-27,28 

Screen Printing 

R-28, T-57,58 

Search and Replace 

R-l8, T-20,21 

Search, continue from EDIT (CTRL-S) 

R-l9, T-19 

Search, for special characters 

R-l 8 

Search Only 

R-l8, T-18 

Search System 

R-18,19, T-18 to 21 

SELECT key 

R-16 

Single sheet printing (,W1) 

R-37 

SHIFT key 

R-l3, T-14 

Soft Hyphens 

R-38, T-54 

SPACE (in memory) 

T-23 

Special EDIT characters 

R-14,15,37,38 

Split justification 

R-37, T-38 

Status line 

R-5,12, T-14,15 

START key 

R-16, T-16 

Start-up procedures 

R-3, T-2 

Stopping/re-starting screen display (CTRL-1) A-4 

Superscripts and subscripts 

R-l5, T-68 

SYSTEM RESET 

R-16 


X-5 



T 


TAB character 

R-37, T-39 

Tab column setting (.Tnn,mm) 

R-35, T-39,40 

Tables, formatting with tabs 

T-41 

TAB key 

R-13, T-39 

Tabs (use in print formating) 

T-39,40 

Template, for merge system 

T-73 

Text buffer 

T-23 

Text entry 

T-3 

Text entry modes 

R-4, T-9 

Tutorial 

T-l to 89 

TXTEND (pointer) 

T-23 

Type-over mode (CTRL-T) 

R-4, T-9 

U 

Undelete command (CTRL-U) 

R-9, T-6 

Underline character 

Page T-69 

Underlining 

R-15, T-68,69 

Using this manual 

1-2 

V 

View-to-print transition (.Vnn) 

R-37, T-57,58 

W 

Wait option (.Wn) 

R-37 

Warning messages 

R-53,53 

Wild-card characters 

R-19,23 

Word wrap on/off (display) 

R-12, T-16 

Word wrap on/off (printout) 

R-35 


X-6 
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